Monobank Mcp Server

Monobank MCP サーバー

Monobank API と連携するための MCP（Model Context Protocol）サーバーです。

クイックインストール

Releases ページから最新の .mcpb バンドルをダウンロードして開いてください。あとは Claude Desktop または Claude Code が処理します。インストール中に Monobank API トークンの入力を求められます。

前提条件

• Node.js 18.0.0 以降
• Monobank API トークン。次の URL から取得できます：https://api.monobank.ua/

注： API トークンはローカルでのみ使用され、Monobank の API 以外に追跡されたり送信されたりすることはありません。

利用可能なツール

サーバーは 3 つのツールを提供します。

1. get_currency_rates - 為替レートを取得します。公開エンドポイントのため、API トークンなしで利用できます。
2. get_client_info - クライアント情報、口座、ジャーを取得します。トークンが必要です。
3. get_statement - 期間を指定して口座またはジャーの明細を取得します。トークンが必要です。期間の上限は 31 日と 1 時間です。

知っておくと便利な動作

• 金額はコペイカではなく通貨単位で返されます。 100,000.00 UAH の残高は 10000000 ではなく 100000 として報告されます。これは、get_client_info と get_statement の両方におけるすべての金額フィールドに適用されます。名前に反して Monobank が絶対額を返す commissionRate も対象です。
• レスポンスはメモリ内にキャッシュされます。 Monobank のレート制限を超えないよう、為替レートは 5 分間、クライアント情報と個別の明細クエリはそれぞれ 60 秒間キャッシュされます。この期間内の再呼び出しでは、HTTP 429 エラーの代わりにキャッシュ済みの結果が返されます。
• 明細の日付は ISO 8601 形式の YYYY-MM-DD で、UTC として解釈されます。to の日付は含まれます。たとえば、2024-10-01 から 2024-10-31 までの明細には、10 月 31 日の全期間が含まれます。to を省略すると、「現在まで」を意味します。
• 明細の account パラメーターの既定値は 0 で、クライアントの既定の口座を指します。get_client_info が返す口座 ID とジャー ID も指定できます。
• MONOBANK_API_TOKEN が必要なのは get_client_info と get_statement のみです。 サーバーはこの環境変数がなくても起動し、get_currency_rates は引き続き利用できます。認証が必要な 2 つのツールは、変数が未設定であることを説明するエラーを返します。

MCP の設定

このサーバーを MCP クライアントで使用するには、設定に追加してください。

{
  "mcpServers": {
    "monobank": {
      "command": "npx",
      "args": ["monobank-mcp-server"],
      "env": {
        "MONOBANK_API_TOKEN": "your_token_here"
      }
    }
  }
}

プロンプトの例

英語

• 「現在の USD から UAH への為替レートを教えて」
• 「口座残高と最近の取引を取得して」
• 「先週の取引をすべて表示して」
• 「昨日は何にお金を使った？」
• 「2024 年 10 月の明細を表示して」
• 「過去 3 日間のクレジットカードの取引をすべて取得して」

Українською

• "Покажи поточний курс долара"
• "Скільки грошей на моїх рахунках?"
• "Покажи виписку за вчора"
• "На що я витратив гроші цього тижня?"
• "Покажи всі транзакції за жовтень"
• "Скільки я витратив на їжу за останній місяць?"

MCPB（ワンクリックインストール）

このサーバーは MCPB バンドルとして提供されており、Claude Desktop と Claude Code にワンクリックでインストールできます。

.mcpb バンドルをローカルでビルドするには、次のコマンドを実行します。

npm run pack:mcpb

これにより monobank-mcp-server.mcpb が生成され、MCPB 対応クライアントに直接インストールできます。インストール中に、Monobank API トークンを安全に入力するよう求められます。

ライセンス

MIT