AI导哈

银行API管理服务器

一个基于Python的Up Bank API封装服务器，通过MCP协议提供账户、交易、类别、标签和Webhook管理功能，适用于金融数据分析和自动化管理。

  • by edkranz
  • Python
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 edkranz/up-mcp

使用说明

上行MCP服务器

Python Up Bank API包装器的MCP包装器 up银行api （归功于 @jcwillox)（一路往下都是包装纸）

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

这是一个模型上下文协议（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.

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

    git clone <repository-url>
cd up-mcp

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

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

  4. 安装依赖项：

    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

  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 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相关问题

相关 MCP