内容
<p align="center">
<img src="https://img.shields.io/badge/tools-4-brightgreen" alt="4 tools" />
<img src="https://img.shields.io/badge/tests-60%20passing-brightgreen" alt="60 tests passing" />
<img src="https://img.shields.io/badge/python-3.10%2B-blue" alt="Python 3.10+" />
<img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License" />
<img src="https://img.shields.io/badge/MCP-FastMCP-purple" alt="FastMCP" />
<img src="https://img.shields.io/badge/security-SSRF%20protected-orange" alt="SSRF protected" />
</p>
<h1 align="center">强大的单银行 MCP 服务器</h1>
<p align="center">
为 Claude 提供最完整的单银行 MCP 服务器。<br/>
</p>
<p align="center">
<strong>Claude 桌面版</strong> · <strong>Claude 代码</strong> · <strong>Claude 协作</strong> · <strong>claude.ai</strong> · <strong>Claude 移动版</strong>
</p>
---
## 工具列表
| 工具 | 身份验证 | 描述 |
|------|------|--------------------|
| `mono_get_currency_rates` | 否 | 具有可选货币筛选器的汇率。缓存 5 分钟。 |
| `mono_get_client_info` | 是 | 账户、余额、具有进度百分比的罐子,FOP 账户 |
| `mono_get_statements` | 是 | 具有收入/支出/净额汇总、现金返还、MCC 代码的交易 |
| `mono_set_webhook` | 是 | 通过 webhook 实现实时交易通知 |
## 快速开始
### 1. 获取您的令牌
前往 **https://api.monobank.ua/** → 使用 Monobank 应用程序登录 → 复制您的个人 API 令牌。
### 2. 安装
<details>
<summary><strong>选项 A:Claude 代码(插件)</strong></summary>
从 Claude 代码市场安装 **mighty-mono-code**,或在本地测试:
```bash
git clone https://github.com/a-i-mighty/mighty-mono-mcp.git
claude code --plugin-dir mighty-mono-mcp/mighty-mono-code
```
输入您的 Monobank 令牌时按提示操作。依赖项会自动安装。
</details>
<details>
<summary><strong>选项 B:Claude 协作(插件)</strong></summary>
从 Claude 协作市场安装 **mighty-mono-work**。与 Claude 代码设置相同 - 输入您的令牌即可。
</details>
<details>
<summary><strong>选项 C:Claude 桌面版(本地,stdio)</strong></summary>
```bash
git clone https://github.com/a-i-mighty/mighty-mono-mcp.git
cd mighty-mono-mcp
pip install -r mighty-mono-mcp/requirements.txt
```
编辑您的 Claude 桌面版配置:
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"monobank": {
"command": "python",
"args": ["C:\\path\\to\\mighty-mono-mcp\\mighty-mono-mcp\\server.py"],
"env": {
"MONOBANK_TOKEN": "your_token_here"
}
}
}
}
```
重启 Claude 桌面版。完成。
</details>
<details>
<summary><strong>选项 D:claude.ai + 移动版(远程连接器)</strong></summary>
此方法适用于 **Claude 桌面版、claude.ai 浏览器版和 Claude 移动版**。
**步骤 1.** 安装 cloudflared(一次性):
```bash
# Windows
winget install cloudflare.cloudflared
# macOS
brew install cloudflare/cloudflare/cloudflared
```
**步骤 2.** 启动服务器:
```bash
set MONOBANK_TOKEN=your_token_here # Windows
export MONOBANK_TOKEN=your_token_here # macOS/Linux
python remote/server.py
```
**步骤 3.** 打开隧道(在第二个终端中):
```bash
cloudflared tunnel --url http://localhost:8000
```
**步骤 4.** 添加到 Claude:
- 前往 **claude.ai** → 设置 → 连接器 → **+ 添加**
- 名称:`Monobank`
- URL:`https://your-tunnel-url.trycloudflare.com/mcp`
- 留空 OAuth → **保存**
立即在浏览器和移动设备上生效。
</details>
<details>
<summary><strong>选项 E:独立技能(无服务器)</strong></summary>
将单个技能文件从 `customize/skills/` 复制到您的 `.claude/skills/` 目录:
```bash
# 复制所有 4 个技能
cp -r customize/skills/mono-* ~/.claude/skills/
# 或仅复制您需要的技能
cp -r customize/skills/mono-currency-rates ~/.claude/skills/
```
这些技能通过 `curl` 教会 Claude 如何直接使用 Monobank API - 无需 MCP 服务器。
</details>
## 安全
该服务器在发布前已进行安全审计:
- **SSRF 保护** - webhook URL 针对私有/保留 IP 进行验证(127.0.0.1、192.168.x.x、169.254.x.x、IPv6 环回地址)
- **路径遍历保护** - 账户 ID 通过正则表达式验证,无法注入
- **输入验证** - 所有输入通过 Pydantic 使用严格模型进行验证(`extra="forbid"`)
- **无秘密泄露** - 错误处理程序清理异常,不暴露内部路径
- **令牌保持本地** - 您的 API 令牌仅发送到 `api.monobank.ua`,从不存储或记录
- **MCP 注释** - 工具声明 `readOnlyHint`、`destructiveHint`、`idempotentHint` 以实现安全 AI 行为
## 测试
涵盖辅助函数、验证、安全性和所有 4 个工具的 60 个测试:
```bash
pip install pytest pytest-asyncio
pytest tests/ -v
```
```
tests/test_server.py::TestWebhookInputValidation::test_localhost_blocked PASSED
tests/test_server.py::TestWebhookInputValidation::test_private_ip_blocked PASSED
tests/test_server.py::TestStatementsInputValidation::test_path_traversal_blocked PASSED
tests/test_server.py::TestHandleApiError::test_generic_error_no_leak PASSED
...
============================== 60 passed in 0.50s ==============================
```
## 比较
| 功能 | **强大单银行** | 服务器 A | 服务器 B | 服务器 C |
|---------|:--------------:|:--------:|:--------:|:--------:|
| 工具 | **4** | 3 | 2 | 1 |
| Webhook 支持 | **是** | 否 | 否 | 否 |
| 远程连接器(claude.ai/移动版) | **是** | 否 | 否 | 否 |
| Markdown 输出 | **是** | JSON | JSON | 部分 |
| 收入/支出总额 | **是** | 否 | 否 | 否 |
| 罐子进度 % | **是** | 否 | 否 | 否 |
| FOP/商业账户 | **是** | 否 | 否 | 否 |
| 货币筛选器 | **是** | 否 | 不适用 | 不适用 |
| SSRF 保护 | **是** | 否 | 否 | 否 |
| 路径遍历保护 | **是** | 否 | 否 | 否 |
| MCP 注释 | **是** | 否 | 否 | 否 |
| 测试 | **60** | 0 | 0 | 0 |
| 安全审计 | **是** | 否 | 否 | 否 |
## 速率限制
| 端点 | 限制 |
|----------|---------------|
| 汇率 | 无限制(服务器端缓存 5 分钟) |
| 客户信息 | 60 秒 1 个请求 |
| 声明 | 60 秒 1 个请求,最大 31 天窗口 |
| Webhook 设置 | 无文档限制 |
## 项目结构
```
monobank-mcp/
├── mighty-mono-mcp/ # Claude 桌面版(stdio 服务器)
│ ├── server.py # MCP 服务器(4 个工具,FastMCP)
│ ├── manifest.json # Claude 桌面版清单
│ └── requirements.txt
├── mighty-mono-code/ # Claude 代码插件
│ ├── .claude-plugin/ # 插件清单
│ ├── skills/ # 4 个专用技能
│ ├── server/ # 捆绑服务器
│ └── hooks/ # 自动依赖安装程序
├── mighty-mono-work/ # Claude 协作插件
│ └── (与 mighty-mono-code 相同结构)
├── customize/skills/ # 独立技能(手动安装)
├── remote/ # 远程 HTTP 服务器(claude.ai/移动版)
├── tests/ # 60 个测试
├── demo.html # 交互式展示
└── start.bat # Windows 快速启动(远程)
```
## 要求
- Python 3.10+
- Monobank 个人 API 令牌([在此获取](https://api.monobank.ua/))
- 对于远程模式: [cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)
## 许可证
MIT - 使用、fork、改进它。
## 由
**[AI 强大](https://github.com/a-i-mighty)** - 构建只需有效的人工智能工具。
---
<p align="center">
<sub>如果这对您有帮助,请给仓库加星 - 它也能帮助其他人找到它。</sub><br/>
</p>
MCP 配置
以下是此 MCP Server 的配置信息,可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
worldmonitor
实时全球情报仪表盘。基于人工智能的新闻聚合、地缘政治监测和基础设施跟踪,提供统一的态势感知界面。
Vibe-Trading
Vibe-Trading:您的个人交易代理
ai-berkshire
AI 时代的伯克希尔:基于 Claude Code 的价值投资研究框架。巴菲特·芒格·段永平·李录四大师方法论 + 多Agent并行研究。
agentic-career-search
Agentic job-discovery backend: 119 ATS & job-board adapters (Greenhouse,...
mctaste-lab
麦麦偏爱实验室|几轮餐品二选一,生成可解释、可调整的偏好与探索推荐。麦当劳 MCP 创意开发大赛独立作品。
maimen-xinshi
麦门心事:把一句心事读成一顿麦当劳,再让三个陌生人决定这顿吃不吃。基于麦当劳中国 MCP 的 Skill + 零依赖单文件演示页。