README
🚀 Up 银行 MCP 服务器
这是一个专为与 Up 银行 API 交互而设计的 MCP 版本 Python 包装器,基于 up-bank-api 项目(感谢 @jcwillox)开发。它由 Claude 助力打造,借助 MCP 启用的客户端(如桌面版 Claude),您能够轻松管理账户、交易、类别、标签和网络钩等操作。
此项目专为 Claude 量身定制,但实用性出色。作为一个模型上下文协议 (MCP) 服务器,它允许您通过 MCP 启用的客户端与 Up 银行 API 进行交互。目前项目已能满足基本需求,若您想对其进行优化以适配大语言模型 (LLM),欢迎贡献代码。开发者创建此项目的初衷主要是学习如何搭建一个 MCP 服务器。
瞧,Claude 都开始“嘲笑”我的交易历史啦,你还能发掘它更多的用途吗?
图:我点太多外卖了吧
🚀 快速开始
先决条件
- Python 3.10 或更高版本
- Up 银行 API 令牌
uv包装管理器
📦 安装指南
- 首先,通过运行以下命令安装
uv:
curl -LsSf https://astral.sh/uv/install.sh | sh
安装后,请重新启动您的终端。
- 克隆此存储库并导航到它:
git clone <repository-url>
cd up-mcp
- 创建并激活虚拟环境:
uv venv
source .venv/bin/activate # 在 Windows 上,使用:.venv\Scripts\activate
- 安装依赖项:
uv pip install -r requirements.txt
💻 使用示例
使用桌面版 Claude 或其他 MCP 启用的客户端
- 打开您的 Claude(或其他 MCP 启用)配置文件:
- macOS/Linux:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%AppData%\Claude\claude
- macOS/Linux:
Scan to join WeChat group