Monobank Mcp Server

Monobank MCP 服务

用于与 Monobank API 集成的 MCP（Model Context Protocol）服务。

快速安装

从 Releases 页面下载最新的 .mcpb bundle 并打开，后续操作由 Claude Desktop 或 Claude Code 完成。安装过程中，系统会提示你输入 Monobank API 令牌。

先决条件

• Node.js 18.0.0 或更高版本
• Monobank API 令牌。你可以在此获取：https://api.monobank.ua/

**注意：**你的 API 令牌仅在本地使用，不会被跟踪，也不会发送到 Monobank API 以外的任何地方。

可用工具

该服务提供三个工具：

1. get_currency_rates - 获取货币汇率。公开端点；无需 API 令牌即可使用。
2. get_client_info - 获取客户端信息、账户和罐子。需要令牌。
3. get_statement - 获取指定日期范围内某个账户或罐子的交易明细。范围最长为 31 天 + 1 小时。

值得了解的行为

• **金额以货币单位返回，而非分。**余额为 100,000.00 UAH 时，返回的是 100000，而不是 10000000。这适用于 get_client_info 和 get_statement 中的所有金额字段，包括 commissionRate，尽管名称如此，Monobank 返回的也是绝对金额。
• 响应会缓存在内存中，以避免超出 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 返回的账户和罐子标识符。
• **MONOBANK_API_TOKEN 仅供 get_client_info 和 get_statement 使用。**服务可在不设置该变量的情况下启动，且 get_currency_rates 仍可正常工作；两个需要身份验证的工具会返回错误，说明该变量未设置。

MCP 配置

如需通过 MCP 客户端使用此服务，请将其添加到配置中：

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

提示词示例

英文

• "Show me the current USD to UAH exchange rate"
• "Get my account balance and recent transactions"
• "Show me all transactions from the last week"
• "What did I spend money on yesterday?"
• "Show my statement for October 2024"
• "Get all my credit card transactions from the last 3 days"

乌克兰语

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

MCPB（一键安装）

此服务提供 MCPB bundle，可在 Claude Desktop 和 Claude Code 中一键安装。

如需在本地构建 .mcpb bundle：

npm run pack:mcpb

这会生成 monobank-mcp-server.mcpb，可直接安装到任何兼容 MCPB 的客户端中。安装过程中，系统会提示你安全地输入 Monobank API 令牌。

许可证

MIT