AgentQL MCP 服务器

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

特征

工具

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

Related MCP server: Fetcher MCP

安装

要使用 AgentQL MCP 服务器从网页中提取数据，您需要通过 npm 安装它，从我们的开发门户获取 API 密钥，然后在您最喜欢的支持 MCP 的应用程序中对其进行配置。

安装包

npm install -g agentql-mcp

配置 Claude

• 通过⌘``,打开 Claude 桌面设置（不要与 Claude 帐户设置混淆）

• 转到开发人员侧边栏部分

• 单击**“编辑配置”**并打开claude_desktop_config.json文件

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

• 重启应用程序

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

点击此处了解有关 Claude 中的 MCP 配置的更多信息。

配置光标

• 打开游标设置

• 前往MCP > MCP 服务器

• 点击**+ 添加新的 MCP 服务器**

• 输入以下内容：

  • 名称：“agentql”（或您喜欢的名称）

  • 类型：“命令”

  • 命令： 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 集成

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

Extract the list of videos from the page https://www.youtube.com/results?search_query=agentql, every video should have a title, an author name, a number of views and a url to the video. Make sure to exclude ads items. Format this as a markdown table.

[!TIP] 如果您的代理抱怨它无法打开 URL 或从网络加载内容，而不是使用 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

检查器将提供一个 URL 来访问浏览器中的调试工具。