# @theyahia/nbk-mcp

[![npm version](https://img.shields.io/npm/v/@theyahia/nbk-mcp.svg)](https://www.npmjs.com/package/@theyahia/nbk-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Курсы валют Национального Банка Казахстана. 5 инструментов. Без авторизации.

MCP-сервер для получения курсов валют НБК, конвертации и отслеживания динамики. Данные берутся напрямую из официального RSS-канала nationalbank.kz.

## Quick Start

### Claude Desktop

Добавьте в `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "nbk": {
      "command": "npx",
      "args": ["-y", "@theyahia/nbk-mcp"]
    }
  }
}
```

### Claude Code

```bash
claude mcp add nbk -- npx -y @theyahia/nbk-mcp
```

### Cursor

Добавьте в `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "nbk": {
      "command": "npx",
      "args": ["-y", "@theyahia/nbk-mcp"]
    }
  }
}
```

## Инструменты

| Инструмент | Описание | Параметры |
|------------|----------|-----------|
| `get_all_rates` | Все текущие курсы валют НБК | нет |
| `get_currency_rate` | Курс конкретной валюты | `currency_code`, `date?` |
| `get_historical_rates` | Курсы на определённую дату | `date` (DD.MM.YYYY) |
| `convert_currency` | Конвертация между валютами | `amount`, `from_currency`, `to_currency?`, `date?` |
| `get_rate_dynamics` | Динамика курса (рост/падение) | `currency_code` |

## Примеры

- "Какой курс доллара к тенге?"
- "Переведи 100000 тенге в рубли"
- "Покажи все курсы валют на сегодня"
- "Какой был курс евро 01.01.2025?"
- "Доллар растёт или падает?"

## HTTP-режим

```bash
npx @theyahia/nbk-mcp --http
# или
HTTP_PORT=8080 npx @theyahia/nbk-mcp --http
```

Эндпоинты:
- `POST /mcp` — Streamable HTTP transport
- `GET /health` — проверка здоровья

## Часть серии Russian & CIS API MCP

Смотрите также: [russian-mcp](https://github.com/theYahia/russian-mcp)

## Лицензия

MIT