AgentQL MCP服务器
这是一个模型上下文协议（MCP）服务器，它集成了 Agent QL的数据提取功能。
特性
工具
extract-web-data-从给定的url中提取结构化数据，使用prompt描述实际数据及其要提取的字段。
安装
要使用AgentQLMCP服务器从网页中提取数据，您需要通过npm安装它，从我们的 开发门户，并在您最喜欢的支持MCP的应用程序中进行配置。
安装软件包
npm install -g agentql-mcp配置Claude
- 打开克劳德桌面 设置 通过
⌘+,（不要与Claude帐户设置混淆） - 首选 开发者 侧边栏部分
- 点击 编辑配置 并打开
claude_desktop_config.json文件 - 添加
agentql服务器内部mcpServers配置文件中的字典 - 重新启动应用程序
{
"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直接 - 添加
agentql服务器内部mcpServers配置文件中的字典
{
"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.\[！提示\] 如果您的代理抱怨它无法打开URL或从web加载内容，而不是使用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"
}
}
}
}\[！注意\] 不要忘记删除默认的AgentQL MCP服务器配置，以免将Claude与两个类似的服务器混淆。
调试
由于MCP服务器通过stdio进行通信，调试可能具有挑战性。我们建议使用 MCP检查员，可作为包脚本使用：
npm run inspector检查器将提供一个URL，用于访问浏览器中的调试工具。
