AgentQL

AgentQL MCP 서버

이것은 AgentQL의 데이터 추출 기능을 통합한 모델 컨텍스트 프로토콜(MCP) 서버입니다.

기능

도구

• extract-web-data - 주어진 'url'에서 'prompt'를 실제 데이터와 추출할 필드에 대한 설명으로 사용하여 구조화된 데이터를 추출합니다.

설치

웹 페이지에서 데이터를 추출하기 위해 AgentQL MCP 서버를 사용하려면, npm을 통해 설치하고, Dev Portal에서 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 구성에 대해 여기에서 자세히 알아보세요.

VS Code 구성

원클릭 설치를 위해 아래 설치 버튼 중 하나를 클릭하세요:

수동 설치

가장 빠른 설치 방법을 위해 이 섹션 상단의 설치 버튼을 클릭하세요. 수동 설치를 위해서는 다음 단계를 따르세요:

VS Code의 사용자 설정(JSON) 파일에 다음 JSON 블록을 추가합니다. 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 설정을 엽니다
• 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 통합 검증

웹에서 데이터를 추출해야 하는 작업을 에이전트에게 부여하세요. 예를 들어:

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] 에이전트가 AgentQL을 사용하는 대신 URL을 열거나 웹에서 콘텐츠를 로드할 수 없다고 불평하는 경우, "도구 사용" 또는 "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] Claude가 두 개의 유사한 서버로 혼동하지 않도록 기본 AgentQL MCP 서버 구성을 제거하는 것을 잊지 마세요.

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector 사용을 권장합니다:

npm run inspector

Inspector는 브라우저에서 디버깅 도구에 접근할 수 있는 URL을 제공합니다.