# 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
Получить список надёжных эмитентов корпоративных облигаций.

## Эмитенты

| Код | Эмитент | Описание |
|-----|---------|----------|
| `sber` | Сбербанк | Крупнейший банк России |
| `vtb` | ВТБ | Второй госбанк России |
| `gazprom` | Газпром | Крупнейшая газовая компания |
| `rzd` | РЖД | Государственная ж/д монополия |
| `rosneft` | Роснефть | Крупнейшая нефтяная компания |
| `rostelecom` | Ростелеком | Государственный оператор связи |
| `domrf` | ДОМ.РФ | Институт развития жилья |
| `rshb` | Россельхозбанк | Госбанк для АПК |
| `fsk` | ФСК ЕЭС | Магистральные электросети |
| `rosseti` | Россети | Холдинг электросетей |
| `transneft` | Транснефть | Монополия нефтепроводов |
| `gtlk` | ГТЛК | Государственная лизинговая компания |
| `rosatom` | Росатом | Госкорпорация атомной энергетики |

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

```bash
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`):

```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)

Пример:
```bash
curl "https://your-app.up.railway.app/api/bonds?type=ofz&limit=5"
```