AgentQL MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，集成了 AgentQL 的数据提取能力。

功能

工具

• 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"
      }
    }
  }
}

在此处阅读有关 Claude 中 MCP 配置的更多信息：https://modelcontextprotocol.io/quickstart/user。

配置 Cursor

• 打开 Cursor 设置
• 转到 MCP > MCP 服务器
• 点击 + 添加新的 MCP 服务器
• 输入以下内容：
  • 名称： "agentql" (或您喜欢的名称)
  • 类型： "command"
  • 命令： env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

在此处阅读有关 Cursor 中 MCP 配置的更多信息：https://docs.cursor.com/context/model-context-protocol。

配置 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"
      }
    }
  }
}

在此处阅读有关 Windsurf 中 MCP 配置的更多信息：https://docs.codeium.com/windsurf/mcp。

验证 MCP 集成

给你的 agent 一个需要从网络提取数据的任务。 例如：

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

[!TIP] 如果您的 agent 抱怨它无法打开网址或从网络加载内容，而不是使用 AgentQL，请尝试添加“使用工具”或“使用 agentql 工具”提示。

开发

安装依赖项：

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 混淆两个相似的服务器。

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。 我们建议使用 MCP Inspector，它作为包脚本提供：

npm run inspector

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