Polygon-io MCP 서버

[!중요한]
:test_tube: 이 프로젝트는 실험 단계이므로 중대한 변경이 있을 수 있습니다.

Polygon.io MCP 서버

LLM 친화적인 인터페이스를 통해 Polygon.io 금융 시장 데이터 API에 대한 액세스를 제공하는 MCP(모델 컨텍스트 프로토콜) 서버입니다.

개요

이 서버는 모든 Polygon.io API 엔드포인트를 MCP 도구로 노출하여 다음을 포함한 포괄적인 금융 시장 데이터에 대한 액세스를 제공합니다.

주식, 옵션, 외환 및 암호화폐 집계 및 막대
실시간 및 과거 거래 및 견적
시장 스냅샷
티커 세부 정보 및 참조 데이터
배당금 및 분할 데이터
금융 기본 사항
시장 현황 및 휴일

설치

필수 조건

파이썬 3.10+
Polygon.io API 키
아스트랄 UV
- 기존 설치의 경우 uvx 명령을 지원하는 버전이 있는지 확인하세요.

클로드 코드

먼저 Claude Code를 설치하세요

지엑스피1

다음 명령을 사용하여 Polygon MCP 서버를 로컬 환경에 추가합니다. 이 명령은 uvx 가 $PATH에 있다고 가정합니다. 그렇지 않은 경우 uvx 의 전체 경로를 제공해야 합니다.

# Claude CLI
claude mcp add polygon -e POLYGON_API_KEY=your_api_key_here -- uvx --from git+https://github.com/polygon-io/mcp_polygon@v0.1.0 mcp_polygon

이 명령은 현재 프로젝트에 MCP 서버를 설치합니다. 전역으로 설치하려면 -s <scope> 플래그를 사용하여 명령을 실행하세요. 더 많은 옵션은 claude mcp add --help 참조하세요.

Claude Code를 시작하려면 터미널에서 claude 실행하세요.

처음 사용하는 경우 설정 프롬프트에 따라 인증을 진행하세요.

Claude Desktop용 MCP 서버가 이미 설치된 경우 claude mcp add-from-claude-desktop 실행할 수도 있습니다.

클로드 데스크탑

Claude Desktop MCP 설치 지침 에 따라 초기 설치를 완료하고 구성 파일을 찾으세요.
다음 예를 참고하여 Polygon의 MCP 서버를 추가하세요. 각 필드를 모두 작성해야 합니다.
1. 경로 uvx 에 대한 경로를 찾은 후 터미널에서 which uvx 실행합니다.
2. <your_api_key_here> 실제 Polygon.io API 키로 바꾸세요.
3. <your_home_directory> 홈 디렉토리 경로로 바꾸세요. 예를 들어, /home/username (Mac/Linux) 또는 C:\Users\username (Windows)입니다.

{
    "mcpServers": {
        "polygon": {
            "command": "<path_to_your_uvx_install>/uvx",
            "args": [
                "--from",
                "git+https://github.com/polygon-io/mcp_polygon@v0.1.0",
                "mcp_polygon"
            ],
            "env": {
                "POLYGON_API_KEY": "<your_api_key_here>",
                "HOME": "<your_home_directory>"
            }
        }
    }
}

사용 예

통합이 완료되면 Claude에게 Polygon.io 데이터에 액세스하라는 메시지를 표시할 수 있습니다.

Get the latest price for AAPL stock
Show me yesterday's trading volume for MSFT
What were the biggest stock market gainers today?
Get me the latest crypto market data for BTC-USD

사용 가능한 도구

이 MCP 서버는 다음을 포함한 모든 Polygon.io API 엔드포인트를 도구로 구현합니다.

get_aggs - 특정 티커에 대한 주식 집계(OHLC) 데이터
list_trades - 과거 거래 데이터
get_last_trade - 해당 심볼의 최신 거래
list_ticker_news - 티커에 대한 최신 뉴스 기사
get_snapshot_ticker - 티커의 현재 시장 스냅샷
get_market_status - 현재 시장 상태 및 거래 시간
list_stock_financials - 기본 재무 데이터
그리고 더 많은 것들이 있습니다...

각 도구는 LLM이 쉽게 처리할 수 있는 표준 JSON으로 응답을 변환하는 동안 Polygon.io SDK 매개변수 구조를 따릅니다.

개발

지역적으로 실행

필수 구성 요소가 설치되어 있는지 확인하세요.

# Sync dependencies
uv sync

# Run the server
POLYGON_API_KEY=your_api_key_here uv run mcp_polygon

  "mcpServers": {
    "polygon": {
      "command": "/your/path/.cargo/bin/uv",
      "args": [
        "run",
        "--with",
        "/your/path/mcp_polygon",
        "mcp_polygon"
      ],
      "env": {
        "POLYGON_API_KEY": "your_api_key_here",
        "HOME": "/Users/danny"
      }
    }
  }

디버깅

디버깅 및 테스트를 위해 MCP Inspector를 사용하는 것이 좋습니다.

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_polygon run mcp_polygon

이렇게 하면 MCP 서버와 직접 상호 작용하고 각 도구의 입력/출력을 볼 수 있는 브라우저 인터페이스가 시작됩니다.

모래밭

기여하다

버그를 발견하셨거나 새로운 기능에 대한 아이디어가 있으시면 먼저 새로운 이슈를 제출하여 저희와 논의해 주세요. 최대 3주 이내에 답변해 드리겠습니다. 미해결 이슈에 대한 PR을 제출하고 싶으신 분은 자원봉사자도 환영합니다. 하지만 사전에 저희와 논의해 주시기 바랍니다. 기존 이슈와 관련이 없거나 사전에 논의되지 않은 PR은 일반적으로 거부됩니다.

Polygon-io MCP Server