AgentQL MCP 服务器

特性

工具

• extract-web-data - 从给定的 'url' 提取结构化数据，使用 'prompt' 作为实际数据描述以及需要提取的字段。

安装

要使用 AgentQL MCP 服务器从网页中提取数据，你需要通过 npm 安装它，获取一个 API 密钥，并在支持 MCP 的应用中配置。

安装包

npm install -g agentql-mcp

配置 Claude

• 打开 Claude Desktop 设置，通过 ⌘+,（不要与 Claude 帐户设置混淆）
• 进入 开发者 侧边栏部分
• 点击 编辑配置 打开 claude_desktop_config.json 文件
• 在配置文件的 mcpServers 字典中添加 agentql 服务器
• 重启应用

{
  "mcpServers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

配置 Cursor

• 打开 Cursor 设置
• 进入 MCP > MCP 服务器
• 点击 + 添加新 MCP 服务器
• 输入以下内容：
  • 名称："agentql"（或你喜欢的名称）
  • 类型："命令"
  • 命令：

    env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

配置 Windsurf

• 打开 Windsurf: MCP 配置面板
• 点击 添加自定义服务器+
• 或者直接打开

  ~/.codeium/windsurf/mcp_config.json

• 在配置文件的 mcpServers 字典中添加 agentql 服务器

{
  "mcpServers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

验证 MCP 集成

给你的代理分配一个任务，该任务需要从网页中提取数据。例如：

从页面 https://www.youtube.com/results?search_query=agentql 提取视频列表，每个视频应包含标题、作者名称、观看次数和视频链接。确保排除广告项。将其格式化为 markdown 表格。

[!TIP] 如果你的代理抱怨无法打开网址或加载网页内容而不是使用 AgentQL，尝试添加 "use tools" 或 "use agentql tool" 提示。

开发

安装依赖：

npm install

构建服务器：

npm run build

用于自动重建的开发：

npm run watch

如果你想尝试开发版本，可以使用以下配置替代默认配置：

{
  "mcpServers": {
    "agentql": {
      "command": "/path/to/agentql-mcp/dist/index.js",
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

[!NOTE] 不要忘记删除默认的 AgentQL MCP 服务器配置，以免混淆 Claude。

调试

npm run inspector

Inspector 将提供一个 URL，在浏览器中访问调试工具。