AgentQL

AgentQL MCP Server

นี่คือเซิร์ฟเวอร์ Model Context Protocol (MCP) ที่ผสานรวมความสามารถในการดึงข้อมูลของ AgentQL

คุณสมบัติ

เครื่องมือ

• extract-web-data - ดึงข้อมูลที่มีโครงสร้างจาก 'url' ที่กำหนด โดยใช้ 'prompt' เป็นคำอธิบายของข้อมูลจริงและฟิลด์ที่จะดึง

การติดตั้ง

ในการใช้ AgentQL MCP Server เพื่อดึงข้อมูลจากหน้าเว็บ คุณต้องติดตั้งผ่าน npm รับ API key จาก Dev Portal ของเรา และกำหนดค่าในแอปที่คุณชื่นชอบซึ่งรองรับ MCP

ติดตั้งแพ็คเกจ

npm install -g agentql-mcp

กำหนดค่า Claude

• เปิด Settings ของ Claude Desktop ผ่าน ⌘+, (อย่าสับสนกับ Claude Account Settings)
• ไปที่ส่วนแถบด้านข้าง Developer
• คลิก Edit Config และเปิดไฟล์ claude_desktop_config.json
• เพิ่มเซิร์ฟเวอร์ agentql ภายในพจนานุกรม mcpServers ในไฟล์กำหนดค่า
• รีสตาร์ทแอป

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

อ่านเพิ่มเติมเกี่ยวกับการกำหนดค่า MCP ใน Claude ที่นี่

กำหนดค่า VS Code

สำหรับการติดตั้งในคลิกเดียว คลิกปุ่มติดตั้งด้านล่าง:

การติดตั้งด้วยตนเอง

คลิกปุ่มติดตั้งที่ด้านบนของส่วนนี้เพื่อวิธีการติดตั้งที่เร็วที่สุด สำหรับการติดตั้งด้วยตนเอง ให้ทำตามขั้นตอนเหล่านี้:

เพิ่มบล็อก JSON ต่อไปนี้ลงในไฟล์ User Settings (JSON) ของคุณใน VS Code คุณสามารถทำได้โดยกด Ctrl + Shift + P และพิมพ์ 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}"
        }
      }
    }
  }
}

หรือคุณสามารถเพิ่มลงในไฟล์ชื่อ .vscode/mcp.json ในพื้นที่ทำงานของคุณ ซึ่งจะช่วยให้คุณแชร์การกำหนดค่ากับผู้อื่นได้

{
  "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}"
      }
    }
  }
}

กำหนดค่า Cursor

• เปิด Cursor Settings
• ไปที่ MCP > MCP Servers
• คลิก + Add new MCP Server
• ป้อนข้อมูลต่อไปนี้:
  • Name: "agentql" (หรือชื่อที่คุณต้องการ)
  • Type: "command"
  • Command: env AGENTQL_API_KEY=YOUR_API_KEY npx -y agentql-mcp

อ่านเพิ่มเติมเกี่ยวกับการกำหนดค่า MCP ใน Cursor ที่นี่

กำหนดค่า Windsurf

• เปิด Windsurf: MCP Configuration Panel
• คลิก Add custom server+
• หรือคุณสามารถเปิด ~/.codeium/windsurf/mcp_config.json โดยตรง
• เพิ่มเซิร์ฟเวอร์ agentql ภายในพจนานุกรม mcpServers ในไฟล์กำหนดค่า

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

อ่านเพิ่มเติมเกี่ยวกับการกำหนดค่า MCP ใน Windsurf ที่นี่

ตรวจสอบการผสานรวม 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 ให้ลองเพิ่มคำใบ้ "use tools" หรือ "use agentql tool"

การพัฒนา

ติดตั้ง dependencies:

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

Inspector จะให้ URL เพื่อเข้าถึงเครื่องมือดีบักในเบราว์เซอร์ของคุณ