Monobank MCP サーバー (Node.js/TypeScript)

Python で書かれた Monobank MCP Server の Node.js/TypeScript 実装です。

Monobank MCP サーバーは、あなたの Monobank 個人アカウント（および公開為替レート）を Model Context Protocol (MCP) ツールとして公開します。

このバージョンについて

これは @nklymok によるオリジナルの Python 実装を Node.js/TypeScript に移植したものです。

• オリジナルの Python バージョン: https://github.com/nklymok/Monobank-MCP

• この TypeScript バージョン: Node.js/TypeScript エコシステムの利点を活かしつつ、同じコアの個人アカウントツールを維持しています。さらに、トークン不要の公開レートツールも追加されています。

Related MCP server: Monobank MCP Server

機能

• 公式の @modelcontextprotocol/sdk を使用した TypeScript/Node.js MCP サーバー

• 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"
         }
       }
     }
   }

   get_client_info または get_statement を使用する場合のみ MONOBANK_API_TOKEN を設定してください。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

   または1行で:

   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 トークン

個人用ツールには Monobank の個人 API トークンが必要です。公式ドキュメントを参照してください: https://api.monobank.ua/index.html

環境変数

ライセンス

MIT