Up Bank MCP Server

上行MCP服务器

为克劳德而作，克劳德（哈哈）

这是一个模型上下文协议（MCP）服务器，提供用于与Up Bank API交互的工具。它允许您通过启用MCP的客户端（如Claude for Desktop）管理帐户、交易、类别、标签和Webhook。

如果你想更好地优化LLM等，请随时贡献。不过，这很好。我只是想学习如何制作MCP服务器。

现在克劳德可以烤我的交易历史了，还有什么好处？

图：我想外卖太多了

先决条件

• Python 3.10或更高版本
• 上行API代币
• uv 包管理器

安装

1. 首先，安装 uv 通过运行：

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

安装后请确保重新启动终端 uv.

1. 克隆此存储库并导航到它：

   git clone 
   cd up-mcp

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

   uv venv
   source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate

1. 安装依赖项：

   uv pip install -r requirements.txt

与Claude一起用于桌面或其他启用MCP的客户端

1. 打开您的Claude（或其他启用MCP的）配置文件：

- macOS/Linux： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %AppData%\Claude\claude_desktop_config.json

1. 添加服务器配置：

{
  "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 API代币 Up Bank网站(https://api.up.com.au/).

1. 重新启动桌面版的Claude。

可用工具

服务器提供以下工具：

• 账户管理（获取账户，获取特定账户）
• 交易管理（获取交易，获取特定交易）
• 类别管理（获取类别，对交易进行分类）
• 标签管理（获取标签，在交易中添加/删除标签）
• 网钩管理（创建，删除，ping网钩）

测试

您可以使用附带的测试服务器 test.py 脚本：

python test.py

这将通过基本功能测试，包括帐户检索和交易列表。

故障排除

如果您遇到问题：

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