AgentQL MCP 服务器

这是一个集成了 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"
      }
    }
  }
}

有关 Claude 中 MCP 配置的更多信息，请参阅此处。

配置 VS Code

要一键安装，请点击以下任意一个安装按钮：

手动安装

点击本节顶部的安装按钮以获取最快的安装方法。对于手动安装，请按照以下步骤操作：

将以下 JSON 块添加到 VS Code 的用户设置（JSON）文件中。您可以通过按 Ctrl + Shift + P 并输入 Preferences: Open User Settings (JSON) 来完成此操作。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "AgentQL API Key",
        "password": true
      }
    ],
    "servers": {
      "agentql": {
        "command": "npx",
        "args": ["-y", "agentql-mcp"],
        "env": {
          "AGENTQL_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

可选地，您可以将其添加到工作区中名为 .vscode/mcp.json 的文件中。这将允许您与其他人共享配置。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "AgentQL API Key",
      "password": true
    }
  ],
  "servers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "${input:apiKey}"
      }
    }
  }
}

配置 Cursor

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

有关 Cursor 中 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"
      }
    }
  }
}

有关 Windsurf 中 MCP 配置的更多信息，请参阅此处。

验证 MCP 集成

给您的代理一个需要从网页中提取数据的任务。例如：

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

[!TIP] 如果您的代理抱怨无法打开 URL 或从网页加载内容而不是使用 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 混淆两个相似的服务器。

调试

由于 MCP 服务器通过 stdio 进行通信，调试可能会比较困难。我们推荐使用 MCP Inspector，它可作为包脚本使用：

npm run inspector

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