yummy-research-mcp

海外・国内のマクロ/市場統計をツールとして公開するMCP serverです。最初のデータセットは市場センチメント/バリュエーション指標ですが、今後はKRX、DART、韓国銀行ECOS、FREDなどを同じパターンで追加できるように設計されています。

現在のツール

name	説明
`get_cnn_fear_greed`	CNN Fear & Greed Index (米国) — 現在値 + 日次履歴
`get_kospi_fear_greed`	indexergo KOSPI恐怖貪欲指数 (idxDetail=24501, 日次)
`get_kospi_buffett`	KOSPIバフェット指数 = 時価総額(20104,D) / 直近4Q GDP合計(09140,Q) × 100
`get_all_indices`	上記3つを一度に返却

各ツールは { name, source, latest, series, ... } 形式のJSONを返却します。

開発環境

uv ベース。

cd ~/workspace/yummy-research-mcp

uv sync                          # 의존성 설치 (.venv 자동 생성)
uv run yummy-research-mcp        # MCP stdio 서버 실행
uv run python -m yummy_research_mcp.sources.cnn        # 단독 페치 디버깅
uv run pytest                    # 라이브 엔드포인트 스모크 테스트

Claude Code / Claude Desktopへの登録

{
  "mcpServers": {
    "yummy-research": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/yeom/workspace/yummy-research-mcp",
        "run",
        "yummy-research-mcp"
      ]
    }
  }
}

新しいデータソースの追加

src/yummy_research_mcp/sources/<source>.py にフェッチャーを作成 — 純粋関数、JSONシリアライズ可能なdictを返却。
src/yummy_research_mcp/server.py の TOOLS レジストリに Tool + コールバックを追加。
tests/ にライブスモークテストを追加。

ディレクトリ

src/yummy_research_mcp/
  __init__.py
  http.py                # 공통 urllib 래퍼 (browser-like UA / Accept-Language)
  server.py              # MCP stdio 서버 + 도구 레지스트리
  sources/
    cnn.py               # CNN Fear & Greed (production.dataviz.cnn.io)
    indexergo.py         # indexergo.com (인라인 ECharts JSON 파싱)
tests/
  test_fetchers.py

データソースメモ

CNN F&G: production.dataviz.cnn.io/index/fearandgreed/graphdata JSON API。ブラウザUA + Origin: edition.cnn.com + Referer が必須 (ないと418エラー)。
indexergo: ページ内のインラインECharts option JSONから、最初の series.data を括弧のバランスを考慮してスキャンし抽出。サイトの /ajaxMakeChart POSTエンドポイントよりも静的HTML解析の方が安定しているため採用。