AgentQL MCP 서버

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

특징

도구

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

설치

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

패키지를 설치하세요

지엑스피1

Claude 구성

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

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

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

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

• 앱을 다시 시작하세요

여기에서 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 서버를 추가합니다.

Windsurf의 MCP 구성에 대한 자세한 내용은 여기에서 확인하세요.

MCP 통합 검증

에이전트에게 웹에서 데이터를 추출하는 작업을 맡겨 보세요. 예:

개발

종속성 설치:

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

개발 버전을 사용해보고 싶다면 기본 구성 대신 다음 구성을 사용할 수 있습니다.

디버깅

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

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