Bunq MCP

邦克 MCP

Bunq（荷兰新银行）的模型上下文协议服务器。

可用工具

该 MCP 服务器提供以下与 Bunq 交互的工具：

1. bunqAccounts - 获取您的 Bunq 帐户，包括帐户类型、余额和 ID 等详细信息
2. getTransactions - 查看特定账户的交易（付款）
3. getRequestInquiries - 获取您从特定账户发送的付款请求
4. createPaymentRequest - 创建付款请求以将钱款存入您的账户
5. getPaymentAutoAllocates - 获取帐户的自动付款分配设置
6. getTopCounterparties - 根据最近的交易获取唯一个人交易对手列表
7. createDraftPayment - 创建具有可选计划的付款草稿（执行前需要在应用程序中进行审核/批准）
8. createPayment - 创建真实货币付款（立即转账）。仅在使用 API 密钥（而非 OAuth）时可用。

可以通过连接到该服务器的任何 MCP 客户端访问这些工具。

验证

此服务器支持两种身份验证模式： OAuth和API Key 。有关更多信息，请参阅Bunq 文档。

通过 Bunq 应用程序创建 API 密钥或 OAuth 客户端：

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 工具：

2. 在 Bunq 应用程序中，创建一个 OAuth 客户端或 API 密钥（参见上文）。
3. （可选）生成新的公钥/私钥对：

注意：此步骤假设openssl已安装并添加到 PATH 中。如果您决定跳过此步骤，则将使用./src/keys/中预先存在的密钥。创建的密钥将覆盖预先存在的密钥，并存储在全局的node_modules目录中。

4. 在任意终端启动 MCP 服务器：

还可以使用BUNQ_CLIENT_ID和BUNQ_CLIENT_SECRET环境变量设置客户端 ID 和密码。

5. 在您最喜欢的编辑器或其他 MCP 客户端（例如 Claude Desktop）中，添加以下内容：

再次，如果需要，请修改端口。之所以使用mcp-remote ，是因为此软件包使用 SSE 传输，而大多数客户端不支持该传输方式。更多信息，请参阅mcp-remote 。

6. 一旦 MCP 服务器启动， mcp-remote就会打开您的浏览器以启动 OAuth 流程。

现在你应该可以提出一个问题，例如

• 我目前的 Bunq 余额是多少？
• 我的前 5 名交易对手是哪些？
• 我上次的交易是什么？

故障排除

• 如果 OAuth 流程有任何问题，您可以尝试删除主目录中由mcp-remote创建的目录： rm -rf ~/.mcp-auth 。

命令行界面

发展

1. 在根目录中创建.dev.vars文件，内容如下：

2. 启动开发服务器

3. 设置 MCP 配置

限制

• 无法使用 OAuth 流程创建付款。只能创建草稿付款。