AgentQL MCP Server

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

特性

工具

• extract-web-data - 从给定的'网址'中提取结构化数据，使用'提示'作为实际数据及其字段的描述。

安装

要使用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配置的信息，请参阅这里。

配置Cursor

• 打开Cursor设置
• 转到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集成

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

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

[!TIP] 如果您的代理抱怨无法打开网址或加载网络内容，而不是使用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服务器通过标准I/O通信，调试可能会很困难。我们建议使用MCP Inspector，它作为一个包脚本提供：

npm run inspector

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