AgentQL

AgentQL MCP Server

Đây là một máy chủ Model Context Protocol (MCP) tích hợp khả năng trích xuất dữ liệu của AgentQL.

Tính năng

Công cụ

• extract-web-data - trích xuất dữ liệu có cấu trúc từ một 'url' cho trước, sử dụng 'prompt' làm mô tả về dữ liệu thực tế và các trường cần trích xuất.

Cài đặt

Để sử dụng AgentQL MCP Server trích xuất dữ liệu từ các trang web, bạn cần cài đặt nó qua npm, lấy khóa API từ Dev Portal của chúng tôi, và cấu hình nó trong ứng dụng yêu thích có hỗ trợ MCP.

Cài đặt gói

npm install -g agentql-mcp

Cấu hình Claude

• Mở Cài đặt Claude Desktop qua ⌘+, (đừng nhầm với Cài đặt Tài khoản Claude)
• Đi tới phần thanh bên Developer
• Nhấp Edit Config và mở tệp claude_desktop_config.json
• Thêm máy chủ agentql vào từ điển mcpServers trong tệp cấu hình
• Khởi động lại ứng dụng

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

Đọc thêm về cấu hình MCP trong Claude tại đây.

Cấu hình VS Code

Để cài đặt một lần nhấp, hãy nhấp vào một trong các nút cài đặt bên dưới:

Cài đặt Thủ công

Nhấp vào các nút cài đặt ở đầu phần này để có phương pháp cài đặt nhanh nhất. Để cài đặt thủ công, hãy làm theo các bước sau:

Thêm khối JSON sau vào tệp Cài đặt Người dùng (JSON) trong VS Code. Bạn có thể thực hiện bằng cách nhấn Ctrl + Shift + P và gõ Preferences: Open User Settings (JSON).

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "AgentQL API Key",
        "password": true
      }
    ],
    "servers": {
      "agentql": {
        "command": "npx",
        "args": ["-y", "agentql-mcp"],
        "env": {
          "AGENTQL_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

Tùy chọn, bạn có thể thêm nó vào tệp có tên .vscode/mcp.json trong không gian làm việc của mình. Điều này cho phép bạn chia sẻ cấu hình với người khác.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "AgentQL API Key",
      "password": true
    }
  ],
  "servers": {
    "agentql": {
      "command": "npx",
      "args": ["-y", "agentql-mcp"],
      "env": {
        "AGENTQL_API_KEY": "${input:apiKey}"
      }
    }
  }
}

Cấu hình Cursor

• Mở Cài đặt Cursor
• Đi tới MCP > MCP Servers
• Nhấp + Add new MCP Server
• Nhập thông tin sau:
  • Tên: "agentql" (hoặc tên bạn muốn)
  • Loại: "command"
  • Lệnh: env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

Đọc thêm về cấu hình MCP trong Cursor tại đây.

Cấu hình Windsurf

• Mở Windsurf: MCP Configuration Panel
• Nhấp Add custom server+
• Hoặc bạn có thể mở trực tiếp ~/.codeium/windsurf/mcp_config.json
• Thêm máy chủ agentql vào từ điển mcpServers trong tệp cấu hình

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

Đọc thêm về cấu hình MCP trong Windsurf tại đây.

Xác thực tích hợp MCP

Giao cho tác nhân của bạn một nhiệm vụ yêu cầu trích xuất dữ liệu từ web. Ví dụ:

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.

[!MẸO] Trong trường hợp tác nhân của bạn phàn nàn rằng nó không thể mở url hoặc tải nội dung từ web thay vì sử dụng AgentQL, hãy thử thêm gợi ý "sử dụng công cụ" hoặc "sử dụng công cụ agentql".

Phát triển

Cài đặt các phụ thuộc:

npm install

Xây dựng máy chủ:

npm run build

Để phát triển với tự động xây dựng lại:

npm run watch

Nếu bạn muốn dùng thử phiên bản phát triển, bạn có thể sử dụng cấu hình sau thay vì cấu hình mặc định:

{
  "mcpServers": {
    "agentql": {
      "command": "/path/to/agentql-mcp/dist/index.js",
      "env": {
        "AGENTQL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

[!LƯU Ý] Đừng quên xóa cấu hình máy chủ AgentQL MCP mặc định để không làm Claude bối rối với hai máy chủ tương tự.

Gỡ lỗi

Vì các máy chủ MCP giao tiếp qua stdio, việc gỡ lỗi có thể gặp khó khăn. Chúng tôi khuyên bạn nên sử dụng MCP Inspector, có sẵn dưới dạng tập lệnh gói:

npm run inspector

Inspector sẽ cung cấp một URL để truy cập các công cụ gỡ lỗi trong trình duyệt của bạn.