AgentQL MCP 서버

이는 AgentQL 의 데이터 추출 기능을 통합한 MCP(Model Context Protocol) 서버입니다.

특징

도구

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

Related MCP server: Fetcher MCP

설치

AgentQL MCP Server를 사용하여 웹 페이지에서 데이터를 추출하려면 npm을 통해 설치하고, Dev Portal 에서 API 키를 받은 다음, MCP를 지원하는 원하는 앱에서 구성해야 합니다.

패키지를 설치하세요

지엑스피1

Claude 구성

• ⌘ + , 를 눌러 Claude 데스크톱 설정을 엽니다(Claude 계정 설정과 혼동하지 마세요).

• 개발자 사이드바 섹션으로 이동

• 구성 편집을 클릭하고 claude_desktop_config.json 파일을 엽니다.

• 구성 파일의 mcpServers 사전 내에 agentql 서버를 추가합니다.

• 앱을 다시 시작하세요

{
  "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 직접 열 수 있습니다.

• 구성 파일의 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

검사기는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL을 제공합니다.