yummy-research-mcp

将海外及国内宏观/市场统计数据作为工具公开的 MCP server。首批数据集为市场情绪/估值指标，但设计上旨在未来以相同模式添加 KRX、DART、韩国银行 ECOS、FRED 等数据源。

当前工具

name	说明
`get_cnn_fear_greed`	CNN 恐惧与贪婪指数 (美股) — 当前值 + 日度历史数据
`get_kospi_fear_greed`	Indexergo KOSPI 恐惧与贪婪指数 (idxDetail=24501, 日度)
`get_kospi_buffett`	KOSPI 巴菲特指数 = 市值(20104,D) / 前 4 季度 GDP 总和(09140,Q) × 100
`get_all_indices`	一次性返回上述三个指标

每个工具均返回 { 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 中编写获取器 (Fetcher) — 纯函数，返回可 JSON 序列化的 dict。
在 src/yummy_research_mcp/server.py 的 TOOLS 注册表中添加 Tool + 可调用对象 (Callable)。
在 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 解析更为稳定，因此采用此方案。