Skip to main content
Glama
Sign In
deenesjakoruzh
yummy-research-mcp

yummy-research-mcp

by Yeom
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

yummy-research-mcp

An MCP server that exposes overseas and domestic macro/market statistics as tools. The first data set consists of market sentiment/valuation indices, but it is designed to add KRX, DART, Bank of Korea ECOS, FRED, etc., in the same pattern in the future.

Current Tools

name

description

get_cnn_fear_greed

CNN Fear & Greed Index (US) — current value + daily history

get_kospi_fear_greed

Indexergo KOSPI Fear & Greed Index (idxDetail=24501, daily)

get_kospi_buffett

KOSPI Buffett Index = Market Cap (20104,D) / Sum of previous 4Q GDP (09140,Q) × 100

get_all_indices

Returns all three of the above at once

Each tool returns a JSON in the format { name, source, latest, series, ... }.

Related MCP server: rays-mcp

Development Environment

Based on 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 Registration

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

Adding New Data Sources

  1. Write a fetcher in src/yummy_research_mcp/sources/<source>.py — pure function, returns a JSON-serializable dict.

  2. Add Tool + callable to the TOOLS registry in src/yummy_research_mcp/server.py.

  3. Add live smoke tests in tests/.

Directory

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

Data Source Notes

  • CNN F&G: production.dataviz.cnn.io/index/fearandgreed/graphdata JSON API. Browser UA + Origin: edition.cnn.com + Referer are required (returns 418 if missing).

  • indexergo: Extract the first series.data from the page's inline ECharts option JSON using balanced bracket scanning. Static HTML parsing was adopted as it is more stable than the site's /ajaxMakeChart POST endpoint.

Available Tools

4 tools
get_all_indicesA

등록된 모든 지표를 한 번에 fetched_at 타임스탬프와 함께 반환.

Inputs: no named parameters.

get_cnn_fear_greedA

CNN Fear & Greed Index — 미국 시장 심리 (0=공포, 100=탐욕). 현재값(이전 종가/1주/1개월/1년 비교 포함) + 일별 히스토리(약 254 영업일).

Inputs: max_history.

get_kospi_buffettA

코스피 버핏지수 = 코스피 시가총액 / 직전 4Q GDP 합 × 100 (%). 원시 시총·GDP 시계열 동봉.

Inputs: no named parameters.

get_kospi_fear_greedA

코스피 공포탐욕지수 (인덱서고 idxDetail=24501, 일간) — 현재값 + 영업일 시계열.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool targets a specific index or a combined endpoint. get_all_indices is a meta-tool returning all indices, while the other three are distinct (US fear/greed, KOSPI Buffett, KOSPI fear/greed), with no overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case: get_<index_name>. The naming is predictable and descriptive, making it easy for an agent to understand the purpose of each tool.

    Tool Count5/5

    With 4 tools, the server is well-scoped for its purpose of providing market sentiment and valuation indices. Each tool serves a clear role without unnecessary bloat or missing essentials.

    Completeness4/5

    The server covers the core indices it advertises (US fear/greed, KOSPI fear/greed and Buffett index) and provides a combined endpoint. A minor gap is the lack of a dedicated US Buffett index, but the combined endpoint likely includes it, so it's not a dead end.

    Maintenance

    ActivityStale
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • OpenKRX MCP Server

      RealYoungk
      A
      license
      B
      quality
      D
      maintenance
      Provides Korean Exchange (KRX) Open API data as MCP tools, supporting 31 APIs for indices, stocks, ETP, bonds, derivatives, commodities, and ESG.
      31
      35 PyPI
      2
      MIT

    • rays-mcp

      ivyyy0601
      F
      license
      Not graded
      quality
      D
      maintenance
      Exposes global market breadth, volume, RSI, volatility, and sentiment for 12 major equity indices (US + Asia) via 5 tools.
      -

    • openkrx-mcp

      joohyukjung
      A
      license
      B
      quality
      D
      maintenance
      MCP server that provides Korean Exchange (KRX) Open API market data as tools, covering indices, stocks, ETPs, bonds, derivatives, commodities, and ESG.
      31
      MIT

    • Global Data MCP

      JingxuanC
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to retrieve US stock market OHLCV data, company fundamentals and financial statements, FRED macroeconomic indicators, market news, Reddit/StockTwits sentiment, and Polymarket prediction market probabilities via simple tools.
      MIT