finance-mcp

시장 데이터를 위한 경량 원격 Model Context Protocol(MCP) 서버로, Cloudflare Workers와 ChatGPT/Codex 같은 AI 클라이언트를 위해 설계되었습니다.

도구

• stock_quote — 최대 10개 티커의 최신/실시간에 가까운 시세 메타데이터

• price_history — 분봉 및 일봉 간격의 OHLCV 과거 데이터

• option_chain — 옵션 만기, 콜, 풋, 내재변동성(IV), 거래량 및 미결제약정

• finance_news — 기업/티커 뉴스 검색

• market_snapshot — S&P 500, 나스닥 종합지수, 다우존스 및 VIX 스냅샷

Related MCP server: Financial Modeling Prep (FMP) MCP Server

데이터 소스

첫 번째 릴리스는 Yahoo Finance의 공개/비공식 엔드포인트를 사용합니다. 실제 지연 시간은 거래소 및 상위 공급자의 규칙에 따라 달라집니다. 상위 공급자의 권한이 실시간 데이터를 명시적으로 보장하지 않는 한, 시세는 실시간에 가까운 것으로 간주하세요. 옵션 데이터는 지연될 수 있으므로, 실행 결정은 브로커/호가창과 대조하여 검증하세요.

로컬 개발

npm install
npm run dev

헬스 체크:

http://localhost:8787/health

MCP 엔드포인트:

http://localhost:8787/mcp

Cloudflare Workers에 배포

npm install
npx wrangler login
npm run deploy

배포 후 Wrangler가 Workers URL을 반환합니다. 원격 MCP 엔드포인트는 다음과 같습니다:

https://<worker-name>.<account-subdomain>.workers.dev/mcp

/health를 사용하여 Worker에 접근 가능한지 확인하세요.

MCP 클라이언트 연결

/mcp로 끝나는 원격 MCP URL을 구성하세요. 이 프로젝트는 Cloudflare의 무상태(stateless) MCP 핸들러를 통해 Streamable HTTP를 사용합니다.

예시 프롬프트

• AAPL과 NVDA의 최신 시세를 가져와.

• AAPL의 5일 5분봉 가격 이력을 보여줘.

• 가장 가까운 AAPL 옵션 체인을 가져와서 거래량이 가장 높은 콜과 풋을 식별해.

• 최신 Apple 금융 뉴스를 찾아줘.

• 미국 시장 스냅샷을 알려줘.

로드맵

다음 모듈에는 SEC 공시, FRED 매크로 데이터, 기관 보유 현황, 내부자 거래, Cboe/OPRA 지원 옵션 피드 및 브로커급 실시간 시장 데이터 제공업체를 추가할 수 있습니다.