使用说明

项目简介

本项目 'Up Bank MCP Server' 是一个 Model Context Protocol (MCP) 服务器的实现，它基于 Python Up Bank API 封装库，旨在为支持 MCP 协议的 LLM 客户端（如 Claude for Desktop）提供与 Up Bank 银行账户交互的能力。通过此服务器，LLM 可以调用预设的工具来获取账户信息、交易记录、管理分类和标签等。

主要功能点

账户管理：
- 获取所有账户列表
- 获取指定账户详情
交易管理：
- 获取交易记录（支持按账户、状态、时间范围、分类、标签等过滤）
- 获取指定交易详情
- 对交易进行分类
- 为交易添加/移除标签
分类管理：
- 获取所有分类列表
- 获取指定分类详情
标签管理：
- 获取所有标签列表
Webhook 管理：
- 获取 Webhook 列表
- 创建 Webhook
- 删除 Webhook
- Ping Webhook

安装步骤

安装 'uv' 包管理器：按照仓库 README.md 提供的步骤安装 'uv'，用于 Python 包和虚拟环境管理。
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
安装完成后，请重启终端。

克隆仓库：

git clone <仓库URL>  # 将 <仓库URL> 替换为 https://github.com/edkranz/up-mcp
cd up-mcp

创建并激活虚拟环境：

uv venv
source .venv/bin/activate  # Linux/macOS
.venv\Scripts\activate  # Windows

安装依赖：

uv pip install -r requirements.txt

服务器配置

要将 'Up Bank MCP Server' 集成到 MCP 客户端（如 Claude for Desktop），您需要配置客户端的 MCP 服务器设置。以下是 Claude for Desktop 的配置示例，您需要根据实际情况修改：

打开 Claude 的配置文件 ('claude_desktop_config.json')：

macOS/Linux: '~/Library/Application Support/Claude/claude_desktop_config.json'
Windows: '%AppData%\Claude\claude_desktop_config.json'

在 'mcpServers' 字段中添加或修改 'up-mcp' 服务器配置：

{
  "mcpServers": {
    "up-mcp": {
      "command": "/ABSOLUTE/PATH/TO/uv",  // 替换为 uv 可执行文件的绝对路径，例如 /Users/yourname/.local/bin/uv
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/up-mcp",  // 替换为 up-mcp 仓库的绝对路径，例如 /Users/yourname/up-mcp
        "run",
        "up_mcp.py"
      ],
      "env": {
        "UP_TOKEN": "up:yeah:your-token-here"  // 替换为你的 Up Bank API Token
      }
    }
  }
}

配置参数说明：

'command': 'uv' 包管理器的可执行文件绝对路径。'uv' 负责运行 Python 代码，这里指向 'uv' 命令。
'args': 传递给 'uv' 命令的参数列表：
- '--directory': 指定工作目录为 'up-mcp' 仓库的绝对路径。
- 'run': 'uv run' 命令用于运行 Python 脚本。
- 'up_mcp.py': 指定要运行的 MCP 服务器 Python 脚本。
'env': 环境变量设置。
- 'UP_TOKEN': 必须配置。这是 Up Bank API 的访问令牌，用于服务器认证。请从 Up Bank 开发者网站获取你的 API Token 并替换 '"up:yeah:your-token-here"'。

获取 Up Bank API Token:

访问 Up Bank 开发者网站并登录你的 Up Bank 账户。
创建一个新的 API 密钥 (API key)。
将生成的 API 密钥复制并粘贴到 'claude_desktop_config.json' 文件的 'UP_TOKEN' 字段中。

重启 Claude for Desktop 使配置生效。

基本使用方法

配置完成后，在 Claude for Desktop 或其他 MCP 客户端中，你可以通过自然语言指令调用 'Up Bank MCP Server' 提供的工具。例如：

你可以询问 Claude “我的银行账户有哪些？” 或 “最近的交易记录是什么？”，Claude 将调用相应的工具并返回 Up Bank 的账户和交易信息。
你可以指示 Claude 对某笔交易进行分类或添加标签，前提是 LLM 客户端支持工具调用和参数传递。

注意: 具体的使用方式取决于 MCP 客户端的功能和界面。请参考你使用的 MCP 客户端的文档，了解如何与 MCP 服务器进行交互和调用工具。

Up Bank MCP 服务器