cassandra-market-research

금융 시장 데이터 MCP 서버입니다. FMP, ThetaData(옵션), Polygon.io(연준 + 공매도 거래량), FRED, Treasury Fiscal Data를 단일 FastMCP 인터페이스로 통합합니다.

주식, SEC 공시, 거시 경제 지표, 옵션 체인, 실적 및 재정 데이터를 다룹니다.

아키텍처

MCP client → market-research.cassandrasedge.com (CF Tunnel)
  → FastMCP backend (port 3003)
    ├─ McpKeyAuthProvider → /keys/validate (auth service)
    ├─ FMP client           → api.financialmodelingprep.com
    ├─ Polygon client       → api.polygon.io
    ├─ FRED/Treasury client → Treasury Fiscal Data + FRED
    └─ ThetaData client     → theta-terminal sidecar
                                ↓
                          ThetaTerminal.jar (Java)
                                ↓
                          ThetaData REST API

ThetaTerminal 사이드카는 별도의 k8s 배포로 실행됩니다. 이는 ThetaData에 로그인하고 REST 호출을 프록시하는 상태 저장 Java 프로세스이기 때문입니다. 자격 증명은 theta-terminal k8s Secret에 저장됩니다.

저장소 구조

cassandra-market-research/
├── backend/
│   ├── src/cassandra_fmp/
│   │   ├── main.py
│   │   ├── mcp_server.py
│   │   ├── config.py
│   │   ├── clients/
│   │   │   ├── polygon.py
│   │   │   ├── thetadata.py
│   │   │   └── treasury.py
│   │   └── tools/                  # Tool modules (register pattern)
│   ├── tests/
│   └── Dockerfile
├── theta-terminal/                 # ThetaTerminal sidecar image
│   ├── Dockerfile                  # Downloads ThetaTerminal.jar at build time
│   └── entrypoint.sh
├── .woodpecker.yaml
└── CLAUDE.md

인증

공유 FastMCP 사이드카 패턴을 사용합니다:

McpKeyAuthProvider는 인증 서비스 /keys/validate를 통해 Bearer mcp_... 토큰을 검증합니다.
업스트림 API 키(FMP, Polygon, FRED)는 사용자별 자격 증명이 아닌 배포 수준의 환경 변수입니다.
ThetaData 자격 증명은 theta-terminal k8s Secret에 저장되며 ThetaTerminal.jar에 의해 소비되고, 이 백엔드에서는 절대 사용되지 않습니다.
ACL 정책은 AUTH_YAML_CONTENT 빌드 인수를 통해 Docker 이미지에 포함됩니다.

환경 변수

변수	필수	설명
`FMP_API_KEY`	예	Financial Modeling Prep API 키
`POLYGON_API_KEY`	아니요	Polygon.io API 키 (연준 데이터 + 공매도 거래량)
`FRED_API_KEY`	아니요	거시 경제 지표를 위한 FRED API 키
`THETA_TERMINAL_URL`	예 (옵션용)	ThetaTerminal REST 엔드포인트 (예: `http://theta-terminal.production.svc.cluster.local:25510`)
`AUTH_URL` / `AUTH_SECRET`	예	인증 서비스 연결

개발

cd backend
uv sync
FMP_API_KEY=<key> THETA_TERMINAL_URL=http://127.0.0.1:25510 uv run cassandra-fmp

배포

Woodpecker CI를 통해 main 브랜치에 푸시하면 자동으로 배포됩니다. BuildKit이 두 개의 이미지를 빌드하여 로컬 레지스트리로 푸시합니다:

backend/에서 market-research:latest 빌드
theta-terminal/에서 theta-terminal:latest 빌드

그 후 ArgoCD가 cassandra-k8s/apps/market-research/와 cassandra-k8s/apps/theta-terminal/을 동기화합니다.

Cassandra 스택의 일부입니다.

Install Server

A

security – no known vulnerabilities

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

FMP MCP Server