yummy-research-mcp

MCP-сервер, предоставляющий зарубежную и внутреннюю макроэкономическую/рыночную статистику в качестве инструментов. Первый набор данных включает показатели рыночных настроений/оценки, но архитектура спроектирована так, чтобы в будущем добавить KRX, DART, ECOS Банка Кореи, FRED и другие источники по тому же шаблону.

Текущие инструменты

name	описание
`get_cnn_fear_greed`	Индекс страха и жадности CNN (США) — текущее значение + ежедневная история
`get_kospi_fear_greed`	Индекс страха и жадности KOSPI от indexergo (idxDetail=24501, ежедневно)
`get_kospi_buffett`	Индекс Баффета для KOSPI = рыночная капитализация (20104,D) / сумма ВВП за последние 4 квартала (09140,Q) × 100
`get_all_indices`	Возвращает все три вышеуказанных индекса одновременно

Каждый инструмент возвращает JSON в формате { name, source, latest, series, ... }.

Среда разработки

На базе 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-сериализуемый словарь.
Добавьте Tool + вызываемый объект в реестр TOOLS в src/yummy_research_mcp/server.py.
Добавьте живой smoke-тест в 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: JSON API production.dataviz.cnn.io/index/fearandgreed/graphdata. Обязательны User-Agent браузера + Origin: edition.cnn.com + Referer (иначе вернет 418).
indexergo: Извлечение первого series.data из встроенного в страницу JSON option библиотеки ECharts путем сканирования сбалансированных скобок. Парсинг статического HTML был выбран как более стабильный метод по сравнению с POST-эндпоинтом /ajaxMakeChart на сайте.