ブンクMCP

Bunq (オランダのネオバンク) 用のモデルコンテキストプロトコル サーバー。

利用可能なツール

この MCP サーバーは、Bunq と対話するための次のツールを提供します。

1. bunqAccounts - アカウントの種類、残高、IDなどの詳細を含むBunqアカウントを取得します

2. getTransactions - 特定のアカウントの取引（支払い）を表示する

3. getRequestInquiries - 特定のアカウントから送信した送金リクエストを取得します

4. createPaymentRequest - アカウントにお金を受け取るための支払いリクエストを作成します

5. getPaymentAutoAllocates - アカウントの自動支払い割り当て設定を取得します

6. getTopCounterparties - 最近の取引に基づいて、一意の個人取引先のリストを取得します

7. createDraftPayment - オプションのスケジュール設定でドラフト支払いを作成します（実行前にアプリでの確認/承認が必要です）

8. createPayment - 現金決済を作成します（即時送金）。APIキー（OAuthではない）を使用する場合のみ利用可能です。

これらのツールには、このサーバーに接続されている任意の MCP クライアントを通じてアクセスできます。

Related MCP server: Tinder API MCP Server

認証

このサーバーは、 OAuthとAPIキーの2つの認証モードをサポートしています。詳細については、 Bunqのドキュメントをご覧ください。

API キーまたは OAuth クライアントの作成は、Bunq アプリを通じて行われます。

1. 左上に顔を押してください

2. 右上の歯車を押します

3. 「開発者」の下で、「OAuth」または「API キー」に移動します。

4. OAuth を使用する場合は、リダイレクト URL を次のように設定します。

   http://localhost:8788/callback

(必要に応じてポートを変更します。)

サーバーを起動する際には、環境変数BUNQ_CLIENT_IDとBUNQ_CLIENT_SECRETを設定するか、環境変数BUNQ_API_KEY設定します。あるいは、コマンドライン引数としてクライアントIDとシークレットまたはAPIキーを渡すこともできます： --bunq-client-id <id> --bunq-client-secret <secret>または--bunq-api-key <key> 。

**注:**実際の現金による非ドラフト支払いを作成する場合は、API キーを使用する必要があります。

インストールと使用方法

1. bunq-mcpおよびmcp-remote CLI ツールをインストールします。

npm install -g bunq-mcp mcp-remote

2. Bunq アプリで、OAuth クライアントまたは API キーを作成します (上記を参照)。

3. (オプション) 新しい公開鍵/秘密鍵のペアを生成します。

bunq-mcp --generate-keys

なお、これはopensslがインストールされ、PATH 上で利用可能であることを前提としています。この手順をスキップした場合、 ./src/keys/にある既存のキーが使用されます。作成されたキーは既存のキーを上書きし、グローバルnode_modulesディレクトリに保存されます。

4. 任意のターミナルで MCP サーバーを起動します。

bunq-mcp --mcp --bunq-client-id <client-id> --bunq-client-secret <client-secret>

クライアント ID とシークレットは、 BUNQ_CLIENT_IDおよびBUNQ_CLIENT_SECRET環境変数を使用して設定することもできます。

5. お気に入りのエディターまたはその他の MCP クライアント (Claude Desktop など) で、以下を追加します。

{
  "mcpServers": {
    "bunq-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8788/sse"]
    }
  }
}

必要に応じてポート番号を変更してください。mcp mcp-remote使用するのは、このパッケージがSSEトランスポートを使用しているためです。ほとんどのクライアントはSSEトランスポートをサポートしていません。詳細については、 mcp-remote を参照してください。

6. MCP サーバーが起動するとすぐに、 mcp-remoteブラウザを開いて OAuth フローを開始します。

次のような質問をすることができるはずです。

• 現在のBunq残高はいくらですか?

• 私の取引相手上位 5 社は何ですか?

• 最後の取引は何でしたか?

トラブルシューティング

• OAuth フローに問題がある場合は、ホーム ディレクトリ内のmcp-remoteによって作成されたディレクトリを削除してみてください: rm -rf ~/.mcp-auth 。

コマンドライン

Usage: bunq-mcp [options]

Options:
  --help              Show help
  --version           Show version
  --generate-keys     Generate private and public key pair for Bunq installation
  --mcp               Start MCP server
  --host <host>       Host (for MCP server)
  --port <port>       Port (for MCP server)
  --bunq-client-id <id>         Bunq client ID (alternative to BUNQ_CLIENT_ID env var)
  --bunq-client-secret <secret> Bunq client secret (alternative to BUNQ_CLIENT_SECRET env var)
  --bunq-api-key <key>          Bunq API key (alternative to BUNQ_API_KEY env var)

発達

1. ルート ディレクトリに次の内容の.dev.varsファイルを作成します。

# When set to 1 the public/private key pair in this repo is used.
IS_DEVELOPMENT=1

# Create OAuth client in the Bunq app
BUNQ_CLIENT_ID=
BUNQ_CLIENT_SECRET=

2. 開発サーバーを起動する

npm run dev

3. MCP構成のセットアップ

{
  "mcpServers": {
    "bunq-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:8788/sse"]
    }
  }
}

制限事項

• OAuthフローを使用して支払いを作成することはできません。下書き支払いのみ作成できます。

{ "Error": [{ "error_description": "Not enough permissions to create payment." }] }