OFZ MCP Server

MCP (Model Context Protocol) сервер для получения данных об облигациях ОФЗ, субфедеральных и корпоративных с MOEX.

Инструменты

get_bonds

Получить список облигаций с фильтрами.

Параметры:

• type — Тип: ofz, subfed, corp или all (по умолчанию all)

• max_months — Максимальный срок до погашения в месяцах

• min_yield — Минимальная доходность в процентах

• issuer — Код эмитента (sber, vtb, gazprom, rzd и др.)

• sort_by — Сортировка: yield, maturity, coupon (по умолчанию yield)

• limit — Лимит результатов (по умолчанию 20)

calculate_investment

Рассчитать доход от инвестиции в облигацию.

Параметры:

• ticker — Тикер облигации (например, SU26238RMFS4)

• amount — Сумма инвестиции в рублях

get_issuers

Получить список надёжных эмитентов корпоративных облигаций.

Related MCP server: Tesouro Direto MCP Server

Эмитенты

Локальный запуск

npm install
npm start

Сервер запустится на порту 3001:

• MCP endpoint: http://localhost:3001/mcp

• REST API: http://localhost:3001/api/bonds

• Health check: http://localhost:3001/health

Деплой на Railway

1. Создать новый проект в Railway

2. Подключить GitHub репозиторий

3. Railway автоматически задеплоит по railway.json

Подключение к Claude

После деплоя добавить MCP сервер в Claude Code (~/.claude.json):

{
  "mcpServers": {
    "ofz-bonds": {
      "url": "https://your-app.up.railway.app/mcp"
    }
  }
}

Или для веб-версии Claude — использовать MCP Connector.

REST API

GET /api/bonds — получить облигации в JSON формате.

Query параметры:

• type — ofz, subfed, corp, all

• max_months — максимальный срок в месяцах

• min_yield — минимальная доходность

• issuer — код эмитента

• sort_by — yield, maturity, coupon

• limit — лимит результатов (по умолчанию 50)

Пример:

curl "https://your-app.up.railway.app/api/bonds?type=ofz&limit=5"