Monobank MCP-Server (Node.js/TypeScript)

Node.js/TypeScript-Implementierung des Monobank MCP-Servers, der ursprünglich in Python geschrieben wurde.

Der Monobank MCP-Server stellt Ihr persönliches Monobank-Konto (sowie öffentliche Wechselkurse) als Model Context Protocol (MCP)-Tools bereit.

Über diese Version

Dies ist eine Node.js/TypeScript-Portierung der ursprünglichen Python-Implementierung von @nklymok.

• Originale Python-Version: https://github.com/nklymok/Monobank-MCP

• Diese TypeScript-Version: Behält die gleichen Kern-Tools für persönliche Konten bei, bietet die Vorteile des Node.js/TypeScript-Ökosystems und enthält zusätzlich ein Tool für öffentliche Wechselkurse, das kein Token benötigt.

Related MCP server: Monobank MCP Server

Funktionen

• TypeScript/Node.js MCP-Server unter Verwendung des offiziellen @modelcontextprotocol/sdk

• MCP-Tools:

  • get_client_info – Kundenidentität, Konten und Jars (erfordert MONOBANK_API_TOKEN).

  • get_statement – Kontoauszug für einen Zeitraum (erfordert Token). Validiert den Zeitraum vor dem API-Aufruf; Antworten verwenden Beträge in Haupteinheiten und ISO 8601 UTC-Zeiten für Transaktionen.

  • get_currency_rates – öffentliche Währungswechselkurse von Monobank (GET /bank/currency). Kein API-Token erforderlich.

Verwendung (veröffentlichtes Paket)

Der einfachste Weg, diesen MCP-Server zu nutzen, ist über das veröffentlichte npm-Paket:

1. Registrieren Sie den Server in Ihrer MCP-Konfiguration

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

   Setzen Sie MONOBANK_API_TOKEN nur, wenn Sie get_client_info oder get_statement verwenden. get_currency_rates funktioniert auch ohne.

2. Starten Sie Ihren MCP-Client – die Tools stehen entsprechend Ihrer Konfiguration zur Verfügung.

Entwicklung

Wenn Sie zur Entwicklung beitragen oder den Server modifizieren möchten:

1. Klonen und Abhängigkeiten installieren

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

2. Starten Sie den Server nach der Installation (prepare führt npm run build aus). Für persönliche Tools setzen Sie MONOBANK_API_TOKEN.

   Windows (PowerShell):

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

   Windows (Eingabeaufforderung):

   set MONOBANK_API_TOKEN=your_token_here
   node dist\index.js

   macOS/Linux:

   export MONOBANK_API_TOKEN=your_token_here
   node dist/index.js

   Oder in einer Zeile:

   MONOBANK_API_TOKEN=your_token_here node dist/index.js

3. Entwicklung mit Hot-Reload (verwendet tsx --watch):

   MONOBANK_API_TOKEN=your_token_here npm run dev

4. Build (TypeScript → dist/):

   npm run build

Tool-Referenz

API-Token

Persönliche Tools benötigen ein persönliches Monobank-API-Token. Siehe die offizielle Dokumentation: https://api.monobank.ua/index.html

Umgebungsvariablen

Lizenz

MIT