cassandra-market-research

金融市場データMCPサーバー。FMP、ThetaData（オプション）、Polygon.io（FRB + 空売り出来高）、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サイドカーは、ThetaDataにログインしてREST呼び出しをプロキシするステートフルなJavaプロセスであるため、個別のk8sデプロイメントとして実行されます。認証情報はtheta-terminal k8sシークレットに格納されます。

リポジトリ構成

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シークレットに格納され、ThetaTerminal.jarによって消費されます。このバックエンドによって消費されることはありません
ACLポリシーは、AUTH_YAML_CONTENTビルド引数を介してDockerイメージに組み込まれています

環境変数

変数	必須	説明
`FMP_API_KEY`	はい	Financial Modeling Prep APIキー
`POLYGON_API_KEY`	いいえ	Polygon.io APIキー（FRBデータ + 空売り出来高）
`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が2つのイメージをビルドし、ローカルレジストリにプッシュします：

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