项目介绍
Bunq MCP
适用于Bunq（荷兰新银行）的模型上下文协议服务器。
可用工具
此MCP服务器提供了以下工具来与Bunq进行交互：
- bunqAccounts - 获取您的Bunq账户详情，如账户类型、余额和ID。
- getTransactions - 查看特定账户的交易（支付）。
- getRequestInquiries - 获取您从特定账户发送的钱请求。
- createPaymentRequest - 创建收款请求以将资金转入您的账户。
- getPaymentAutoAllocates - 获取账户的自动付款分配设置。
- getTopCounterparties - 根据最近的交易获取唯一的人类交易对手列表。
- createDraftPayment - 创建带有可选调度的草稿支付（在应用中需要审核/批准后才能执行）。
- createPayment - 创建实际支付（立即转账）。仅在使用API密钥时可用（不支持OAuth）。
这些工具可以通过连接到此服务器的任何MCP客户端访问。
认证
此服务器支持两种认证模式：OAuth 和 API Key。更多详情请参阅Bunq 文档。
创建API密钥或OAuth客户端是在Bunq应用中完成的：
- 按住左上角的头像。
- 按住右上角的齿轮图标。
- 在“开发者”下，选择“OAuth”或“API Keys”。
- 如果使用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密钥。
安装及使用
- 安装
bunq-mcp和mcp-remote命令行工具：
npm install -g bunq-mcp mcp-remote
-
在Bunq应用中创建一个OAuth客户端或API密钥（见上文）。
-
（可选）生成新的公钥/私钥对：
bunq-mcp --generate-keys
请注意，这假设已安装并可在PATH中找到 openssl。如果您决定跳过此步骤，则会使用 ./src/keys/ 目录中的现有密钥。生成的密钥将覆盖现有的密钥，并存储在全球 node_modules 目录中。
- 在任何终端中启动MCP服务器：
bunq-mcp --mcp --bunq-client-id <client-id> --bunq-client-secret <client-secret>
客户端ID和密钥也可以通过环境变量 BUNQ_CLIENT_ID 和 BUNQ_CLIENT_SECRET 设置。
- 在您喜欢的编辑器或其他MCP客户端（如Claude Desktop）中添加以下内容：
{
"mcpServers": {
"bunq-mcp": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8788/sse"]
}
}
}
再次，如有必要，请修改端口。mcp-remote 被使用是因为该包使用SSE传输，而大多数客户端并不支持这一点。有关更多信息，请参阅mcp-remote。
- 一旦MCP服务器启动，
mcp-remote应该会在浏览器中打开以开始OAuth流程。
现在，您应该能够提问，例如：
- 我当前的Bunq余额是多少？
- 我的前五大交易对手是谁？
- 我的最后一笔交易是什么？
故障排除
- 如果OAuth流程出现问题，您可以尝试删除
mcp-remote在您的主目录中创建的目录：rm -rf ~/.mcp-auth。
命令行
用法：bunq-mcp [选项]
选项：
--help 显示帮助
--version 显示版本
--generate-keys 为Bunq安装生成私钥和公钥对
--mcp 启动MCP服务器
--host <host> 主机（用于MCP服务器）
--port <port> 端口（用于MCP服务器）
--bunq-client-id <id> Bunq客户端ID（替代BUNQ_CLIENT_ID环境变量）
--bunq-client-secret <secret> Bunq客户端密钥（替代BUNQ_CLIENT_SECRET环境变量）
--bunq-api-key <key> Bunq API密钥（替代BUNQ_API_KEY环境变量）
开发
- 在根目录中创建
.dev.vars文件，内容如下：
# 当设置为1时，使用此仓库中的公钥/私钥对。
IS_DEVELOPMENT=1
# 在Bunq应用中创建OAuth客户端
BUNQ_CLIENT_ID=
BUNQ_CLIENT_SECRET=
- 启动开发服务器
npm run dev
- 设置MCP配置
{
"mcpServers": {
"bunq-mcp": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:8788/sse"]
}
}
}
限制
- 使用OAuth流程无法创建支付。只能创建草稿支付。
{ "Error": [{ "error_description": "没有足够的权限创建支付。" }] }