Up Bank MCP 服务器

Python Up Bank API 包装器 up-bank-api 的 MCP 包装器（感谢 @jcwillox）（层层包装）

由 Claude 为 Claude 制作（哈哈）

这是一个 Model Context Protocol (MCP) 服务器，提供了与 Up Bank API 交互的工具。它允许您通过支持 MCP 的客户端（如 Claude for Desktop）管理账户、交易、类别、标签和 Webhook。

如果您希望更好地优化它以适应大型语言模型等，请随意贡献。不过目前这样也很好。我只是想学习如何制作一个 MCP 服务器。

现在 Claude 可以吐槽我的交易记录了，它还有什么其他用途？

图：大概是因为外卖点得太多了

前提条件

• Python 3.10 或更高版本
• Up Bank API 令牌
• uv 包管理器

安装

1. 首先，通过运行以下命令安装 uv：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   安装 uv 后请确保重启终端。

2. 克隆此仓库并导航到其中：

   git clone <repository-url>
   cd up-mcp
   

3. 创建并激活虚拟环境：

   uv venv
   source .venv/bin/activate  # 在 Windows 上使用：.venv\Scripts\activate
   

4. 安装依赖项：

   uv pip install -r requirements.txt
   

与 Claude for Desktop 或其他支持 MCP 的客户端一起使用

1. 打开您的 Claude（或其他支持 MCP 的客户端）配置文件：

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

2. 添加服务器配置：

{
  "mcpServers": {
    "up-mcp": {
      "command": "/ABSOLUTE/PATH/TO/uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/up-mcp",
        "run",
        "up_mcp.py"
      ],
      "env": {
        "UP_TOKEN": "up:yeah:your-token-here"
      }
    }
  }
}

将 /ABSOLUTE/PATH/TO/uv 替换为您的 uv 可执行文件的绝对路径。
将 /ABSOLUTE/PATH/TO/up-mcp 替换为您的项目目录的绝对路径。
将 up:yeah:your-token-here 替换为您的 Up Bank API 令牌。

从 Up Bank 网站 (https://api.up.com.au/) 获取您的 Up Bank API 令牌。

1. 重新启动 Claude for Desktop。

可用工具

服务器提供以下工具：

• 账户管理（获取账户、获取特定账户）
• 交易管理（获取交易、获取特定交易）
• 类别管理（获取类别、分类交易）
• 标签管理（获取标签、向交易添加或移除标签）
• Webhook 管理（创建、删除、ping Webhook）

测试

您可以使用包含的 test.py 脚本来测试服务器：

python test.py

这将运行包括账户检索和交易列表在内的基本功能测试。

故障排除

如果遇到问题：

1. 验证您的 UP_TOKEN 环境变量是否设置正确
2. 检查所有依赖项是否已正确安装
3. 确保您使用的是 Python 3.10 或更高版本
4. 检查 Claude 的日志以查找与 MCP 相关的问题