Agentql MCP

🚀 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 配置 這裡。

配置 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 上的視頻列表，每個視頻應包含標題、作者名稱、觀看次數和視頻 URL。確保排除廣告項。將其格式化為 Markdown 表格。

⚠️ 重要提示

如果你的代理抱怨無法打開 URLs 或從網頁加載內容，嘗試添加 "使用工具" 或 "使用 agentql 工具" 提示。

💻 使用示例

基礎用法

提取頁面 https://www.youtube.com/results?search_query=agentql 上的視頻列表，每個視頻應包含標題、作者名稱、觀看次數和視頻 URL。確保排除廣告項。將其格式化為 Markdown 表格。

🔧 技術細節

開發

安裝依賴：

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，用於在瀏覽器中訪問調試工具。