eiu-mcp-server

Сервер на базе Model Context Protocol, который даёт Claude (или любому MCP-совместимому LLM-клиенту) структурированный и эффективный по токенам доступ к API данных EIU — около 200 стран и 320 рядов экономических показателей, включая исторические данные и прогнозы.

Он предоставляет три инструмента:

Справочные данные загружаются один раз за сессию и кэшируются в памяти, поэтому просмотр и поиск не требуют дополнительных API-вызовов.

Предварительные требования

• Доступ к Developer Portal EIU API. Это не самообслуживание. Напишите на economicssupport@economist.com и запросите доступ к Developer Portal. Они вручную создадут вашу учётную запись. Вам понадобятся все три элемента: адрес электронной почты портала, пароль портала и API-ключ, указанный на портале.

• На вашей машине должен быть установлен uv. Одна команда:

  curl -LsSf https://astral.sh/uv/install.sh | sh

Вам не нужно клонировать этот репозиторий или создавать виртуальное окружение — uvx берёт на себя всё, начиная с git-URL.

Related MCP server: EODHD MCP Server

Установка

Claude Code

Установка одной командой, выполненной из папки, чей .env содержит ваши три значения EIU. Оболочка читает их, поэтому учётные данные никогда не появятся в вашем диалоге:

set -a; source .env; set +a
claude mcp add --scope user eiu \
  -e EIU_API_KEY="$EIU_API_KEY" \
  -e EIU_EMAIL="$EIU_EMAIL" \
  -e EIU_PASSWORD="$EIU_PASSWORD" \
  -- uvx --from git+https://github.com/joshua-bailey/eiu-mcp-server.git eiu-mcp-server

Либо добавьте запись в .mcp.json вручную:

{
  "mcpServers": {
    "eiu": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/joshua-bailey/eiu-mcp-server.git",
        "eiu-mcp-server"
      ],
      "env": {
        "EIU_API_KEY": "${EIU_API_KEY}",
        "EIU_EMAIL": "${EIU_EMAIL}",
        "EIU_PASSWORD": "${EIU_PASSWORD}"
      }
    }
  }
}

Затем перезапустите Claude Code. Три инструмента eiu_* должны появиться в разделе /mcp.

Claude Desktop

Тот же фрагмент JSON, размещённый в разделе mcpServers в:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Desktop не раскрывает ссылки ${VAR}, поэтому впишите туда буквальные значения.

Фиксация версии

По умолчанию uvx устанавливает последний коммит в ветке main. Чтобы зафиксировать конкретный тегированный релиз, добавьте @<tag> к git-URL, например:

"git+https://github.com/joshua-bailey/eiu-mcp-server.git@v0.1.0"

Переменные окружения

Нужны все три. Сервер выполняет вход с помощью адреса электронной почты и пароля, чтобы получить bearer-токен, а затем отправляет этот токен вместе с API-ключом в каждом запросе. Токен кэшируется в памяти и обновляется до истечения срока действия.

Использование

После регистрации MCP спрашивайте у Claude, например:

• «Search EIU for current account balance series»

• «What EIU series codes cover consumer prices?»

• «Pull EIU annual GDP growth (DGDP) for the US, UK and China from 2015 to 2030»

• «Show me EIU quarterly inflation forecasts for Brazil, Mexico and Chile»

Claude выберет нужный инструмент и вызовет его.

Коды

• Географии — двухбуквенные коды ISO в верхнем регистре: US, GB, CN, BR.

• Ряды — собственные короткие коды EIU в верхнем регистре, например DGDP, DCPI. Используйте eiu_search или eiu_browse, чтобы найти их, а не угадывать.

• Частота — одно из значений Yearly, Quarterly или Monthly.

eiu_get_data ограничивает ответ 200 точками данных для экономии токенов и сообщает об этом при усечении. Сузьте диапазон дат или список стран, чтобы увидеть остальное.

Справочник по API

Базовый API описан в документации на developer.eiu.com/help/overview. Сервер обращается к https://api.eiu.com/v1.

Лицензия

MIT — см. LICENSE. Применяется только к коду обёртки в этом репозитории. Зависимости сохраняют свои собственные лицензии. Данные EIU являются платной подпиской, и их условия использования действуют независимо от данной обёртки.