yummy-research-mcp

해외·국내 거시/시장 통계를 도구로 노출하는 MCP server. 첫 번째 데이터 셋은 시장 심리/밸류에이션 지표지만, 향후 KRX·DART·한국은행 ECOS·FRED 등을 같은 패턴으로 추가하도록 설계.

현재 도구

각 도구는 { 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"
      ]
    }
  }
}

새 데이터 소스 추가

1. src/yummy_research_mcp/sources/<source>.py에 페처 작성 — 순수 함수, JSON-직렬화 가능한 dict 반환.
2. src/yummy_research_mcp/server.py의 TOOLS 레지스트리에 Tool + 콜러블 추가.
3. 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 파싱이 안정적이라 그쪽 채택.