AgentQL MCP 服务器

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

特征

工具

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

安装

要使用 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 来访问浏览器中的调试工具。

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

extract-web-data

提供 AgentQL 数据提取功能的服务器，使 AI 代理能够从非结构化 Web 中获取结构化数据

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Server Firecrawl
Msparihar
A
security
A
license
A
quality
A server that provides web scraping and intelligent content searching capabilities using the Firecrawl API, enabling AI agents to extract structured data from websites and perform content searches.
Last updated -
5
2
TypeScript
MIT License
MCP Firecrawl Server
codyde
A
security
F
license
A
quality
A server that provides tools to scrape websites and extract structured data from them using Firecrawl's APIs, supporting both basic website scraping in multiple formats and custom schema-based data extraction.
Last updated -
2
JavaScript
Deep Research MCP Server
Hajime-Y
-
security
A
license
-
quality
An agent-based tool that provides web search and advanced research capabilities including document analysis, image description, and YouTube transcript retrieval.
Last updated -
7
Python
Apache 2.0
Scrapezy MCP Server
kxkaloo
A
security
A
license
A
quality
A Model Context Protocol server that enables AI models to extract structured data from websites through the extract\_structured\_data tool.
Last updated -
1
12
JavaScript
MIT License

View all related MCP servers

AgentQL MCP Server