Monobank MCP 服务器 (Node.js/TypeScript)

Node.js/TypeScript 实现 的 Monobank MCP Server（原版使用 Python 编写）。

Monobank MCP 服务器将您的 Monobank 个人账户（以及公开汇率）作为模型上下文协议 (MCP) 工具公开。

关于此版本

这是由 @nklymok 开发的原始 Python 实现的 Node.js/TypeScript 移植版。

• 原始 Python 版本: https://github.com/nklymok/Monobank-MCP

• 此 TypeScript 版本: 保留了相同的核心个人账户工具，并结合了 Node.js/TypeScript 生态系统的优势，此外还增加了一个无需令牌的公开汇率工具。

Related MCP server: Monobank MCP Server

功能

• 使用官方 @modelcontextprotocol/sdk 的 TypeScript/Node.js MCP 服务器

• MCP 工具：

  • get_client_info – 客户身份、账户和储蓄罐（需要 MONOBANK_API_TOKEN）。

  • get_statement – 指定时间窗口内的账户对账单（需要令牌）。在调用 API 之前会验证时间段；响应使用主单位金额，交易时间使用 ISO 8601 UTC 格式。

  • get_currency_rates – 来自 Monobank 的公开货币汇率 (GET /bank/currency)。无需 API 令牌。

使用方法（已发布包）

使用此 MCP 服务器最简单的方法是通过已发布的 npm 包：

1. 在您的 MCP 配置中注册服务器

   {
     "mcpServers": {
       "monobank-mcp": {
         "command": "npx",
         "args": ["-y", "@alerix/monobank-mcp"],
         "env": {
           "MONOBANK_API_TOKEN": "your_token_here"
         }
       }
     }
   }

   仅当您使用 get_client_info 或 get_statement 时才需要设置 MONOBANK_API_TOKEN。get_currency_rates 无需此令牌即可工作。

2. 运行您的 MCP 客户端 – 工具将根据您的配置可用。

开发

如果您想贡献代码或修改服务器：

1. 克隆并安装依赖项

   git clone https://github.com/aler1x/monobank-mcp.git
   cd monobank-mcp
   npm install

2. 安装后运行服务器（prepare 会执行 npm run build）。对于个人工具，请设置 MONOBANK_API_TOKEN。

   Windows (PowerShell):

   $env:MONOBANK_API_TOKEN="your_token_here"
   node dist/index.js

   Windows (命令提示符):

   set MONOBANK_API_TOKEN=your_token_here
   node dist\index.js

   macOS/Linux:

   export MONOBANK_API_TOKEN=your_token_here
   node dist/index.js

   或单行命令:

   MONOBANK_API_TOKEN=your_token_here node dist/index.js

3. 热重载开发 (使用 tsx --watch):

   MONOBANK_API_TOKEN=your_token_here npm run dev

4. 构建 (TypeScript → dist/):

   npm run build

工具参考

API 令牌

个人工具需要 Monobank 个人 API 令牌。请参阅官方文档：https://api.monobank.ua/index.html

环境变量

许可证

MIT