Monobank MCP Server (Node.js/TypeScript)

Node.js/TypeScript реализация Monobank MCP Server, изначально написанного на Python.

Monobank MCP Server предоставляет доступ к вашему личному счету Monobank (и публичным курсам валют) в качестве инструментов протокола Model Context Protocol (MCP).

Об этой версии

Это Node.js/TypeScript порт оригинальной реализации на Python от @nklymok.

• Оригинальная версия на Python: https://github.com/nklymok/Monobank-MCP

• Эта версия на TypeScript: Сохраняет те же основные инструменты для работы с личным счетом, используя преимущества экосистемы Node.js/TypeScript, а также добавляет инструмент для получения публичных курсов валют, не требующий токена.

Related MCP server: Monobank MCP Server

Возможности

• MCP-сервер на TypeScript/Node.js с использованием официального @modelcontextprotocol/sdk

• Инструменты MCP:

  • get_client_info – информация о клиенте, счетах и банках (требуется MONOBANK_API_TOKEN).

  • get_statement – выписка по счету за временной интервал (требуется токен). Проверяет период перед вызовом API; ответы содержат суммы в основных единицах и время транзакций в формате ISO 8601 UTC.

  • get_currency_rates – публичные курсы обмена валют от Monobank (GET /bank/currency). API-токен не требуется.

Использование (опубликованный пакет)

Самый простой способ использовать этот MCP-сервер — через опубликованный npm-пакет:

1. Зарегистрируйте сервер в вашей конфигурации MCP

   {
     "mcpServers": {
       "monobank-mcp": {
         "command": "npx",
         "args": ["-y", "@alerix/monobank-mcp"],
         "env": {
           "MONOBANK_API_TOKEN": "your_token_here"
         }
       }
     }
   }

   Установите MONOBANK_API_TOKEN только если вы используете get_client_info или get_statement. get_currency_rates работает без него.

2. Запустите ваш MCP-клиент – инструменты будут доступны в соответствии с вашей конфигурацией.

Разработка

Если вы хотите внести свой вклад или изменить сервер:

1. Клонируйте репозиторий и установите зависимости

   git clone https://github.com/aler1x/monobank-mcp.git
   cd monobank-mcp
   npm install

2. Запустите сервер после установки (prepare выполняет npm run build). Для личных инструментов установите MONOBANK_API_TOKEN.

   Windows (PowerShell):

   $env:MONOBANK_API_TOKEN="your_token_here"
   node dist/index.js

   Windows (Командная строка):

   set MONOBANK_API_TOKEN=your_token_here
   node dist\index.js

   macOS/Linux:

   export MONOBANK_API_TOKEN=your_token_here
   node dist/index.js

   Или одной строкой:

   MONOBANK_API_TOKEN=your_token_here node dist/index.js

3. Разработка с горячей перезагрузкой (использует tsx --watch):

   MONOBANK_API_TOKEN=your_token_here npm run dev

4. Сборка (TypeScript → dist/):

   npm run build

Справочник инструментов

API-токен

Для личных инструментов требуется персональный API-токен Monobank. См. официальную документацию: https://api.monobank.ua/index.html

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

Лицензия

MIT