yummy-research-mcp

Un servidor MCP que expone estadísticas macroeconómicas y de mercado nacionales e internacionales como herramientas. El primer conjunto de datos consiste en indicadores de sentimiento y valoración de mercado, pero está diseñado para añadir en el futuro KRX, DART, ECOS del Banco de Corea, FRED, etc., siguiendo el mismo patrón.

Herramientas actuales

nombre	descripción
`get_cnn_fear_greed`	Índice CNN Fear & Greed (EE. UU.) — valor actual + historial diario
`get_kospi_fear_greed`	Índice de miedo y codicia del KOSPI de indexergo (idxDetail=24501, diario)
`get_kospi_buffett`	Índice Buffett del KOSPI = Capitalización bursátil (20104,D) / Suma del PIB de los últimos 4T (09140,Q) × 100
`get_all_indices`	Devuelve los tres anteriores a la vez

Cada herramienta devuelve un JSON con el formato { name, source, latest, series, ... }.

Entorno de desarrollo

Basado en 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                    # 라이브 엔드포인트 스모크 테스트

Registro en Claude Code / Claude Desktop

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

Añadir nuevas fuentes de datos

Escribir un extractor en src/yummy_research_mcp/sources/<source>.py — función pura, devuelve un dict serializable en JSON.
Añadir Tool + invocable al registro TOOLS en src/yummy_research_mcp/server.py.
Añadir pruebas de humo en vivo en tests/.

Directorio

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

Notas sobre las fuentes de datos

CNN F&G: API JSON de production.dataviz.cnn.io/index/fearandgreed/graphdata. Requiere UA de navegador + Origin: edition.cnn.com + Referer (si no, devuelve 418).
indexergo: Extrae el primer series.data del JSON option de ECharts insertado en la página mediante escaneo de paréntesis equilibrados. Se adoptó el análisis de HTML estático porque es más estable que el endpoint POST /ajaxMakeChart del sitio.