STARWARCLOUD STARWAR.AI
返回市场
上行银行MCP服务器

上行银行MCP服务器

作者：alex10929 星标更新：2025-11-10
安装使用来源：spider==github.com

项目介绍

Up 银行 MCP 服务器

这是一个提供与 Up 银行 API 集成的 Model Context Protocol (MCP) 服务器。此服务器允许 Claude 与您的 Up 银行数据进行交互，包括账户、交易和类别。

<a href="https://glama.ai/mcp/servers/@alex1092/up-bank-mcp-server"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=522212231,2894225412&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Up 银行 MCP 服务器" /> </a>

功能

  • 账户管理：列出所有账户，获取账户详情和余额
  • 交易历史：通过灵活过滤（日期范围、状态、类别、标签）查询交易
  • 类别信息：访问 Up 的消费类别以获得更好的交易洞察
  • 类型安全：使用 TypeScript 构建，确保可靠性和开发者体验
  • 安全：使用 Up 的个人访问令牌进行身份验证

先决条件

  • Node.js 18 或更高版本
  • 一个 Up 银行账户
  • Up 个人访问令牌

安装

  1. 克隆或下载此仓库：
cd up-mcp-server
  1. 安装依赖项：
npm install
  1. 构建服务器：
npm run build

获取您的 Up API 令牌

  1. 在手机上打开 Up 应用
  2. 向右滑动并选择“数据共享”
  3. 点击“个人访问令牌”
  4. 选择“生成令牌”
  5. 选择您希望令牌持续的时间
  6. 按照提示安全地复制您的令牌

重要：请保护好您的令牌！不要分享它或将它提交到版本控制中。

配置

Claude Desktop 配置

在您的 Claude Desktop 配置文件中添加以下内容：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "up-banking": {
      "command": "node",
      "args": ["/绝对路径/to/up-mcp-server/build/index.js"],
      "env": {
        "UP_API_TOKEN": "您的_up_api_token_在这里"
      }
    }
  }
}

将 /绝对路径/to/up-mcp-server 替换为此目录的实际路径，并将 您的_up_api_token_在这里 替换为您自己的 Up 个人访问令牌。

可选：使用 npx

您也可以直接使用 npx 运行服务器：

{
  "mcpServers": {
    "up-banking": {
      "command": "npx",
      "args": ["-y", "/绝对路径/to/up-mcp-server"],
      "env": {
        "UP_API_TOKEN": "您的_up_api_token_在这里"
      }
    }
  }
}

可用工具

up_ping

测试 API 连接并验证身份验证是否正常工作。

up_list_accounts

列出所有账户，可选按账户类型或所有权过滤。

参数：

  • accountType（可选）：按“SAVER”、“TRANSACTIONAL”或“HOME_LOAN”过滤
  • ownershipType（可选）：按“INDIVIDUAL”或“JOINT”过滤

up_get_account

获取特定账户的详细信息。

参数：

  • accountId（必需）：账户 ID

up_list_transactions

列出交易，具有全面的过滤选项。

参数：

  • accountId（可选）：按特定账户过滤
  • status（可选）：“HELD”（待处理）或“SETTLED”
  • since（可选）：起始日期，RFC 3339 格式（例如，“2024-01-01T00:00:00+10:00”）
  • until（可选）：结束日期，RFC 3339 格式
  • category（可选）：类别 ID（例如，“restaurants-and-cafes”）
  • tag（可选）：交易标签
  • pageSize（可选）：结果数量（1-100）

up_get_transaction

获取特定交易的详细信息。

参数：

  • transactionId（必需）：交易 ID

up_list_categories

列出 Up 中的所有消费类别。

参数：

  • parentId（可选）：按特定父类别的子类过滤

up_get_category

获取特定类别的详细信息。

参数：

  • categoryId（必需）：类别 ID（例如，“restaurants-and-cafes”）

使用示例

配置完成后，您可以向 Claude 提问如下问题：

  • “我的当前账户余额是多少？”
  • “显示我上个月的所有交易”
  • “这周我在餐馆花了多少钱？”
  • “列出我所有的储蓄账户”
  • “显示我支出账户中的待处理交易”
  • “显示标记为‘度假’的所有交易”

开发

监视模式

用于开发时自动重新编译：

npm run dev

测试连接

配置后，重启 Claude Desktop 并尝试：

你能 ping Up API 来验证连接吗？

故障排除

“UP_API_TOKEN 环境变量是必需的”

确保您已将 Up API 令牌添加到您的 Claude Desktop 配置的 env 部分。

“Up API 错误：401”

您的 API 令牌无效或已过期。在 Up 应用中生成新的令牌。

服务器未出现在 Claude 中

  1. 检查 build/index.js 的路径是否绝对且正确
  2. 验证配置文件中的 JSON 语法是否有效
  3. 完全重启 Claude Desktop
  4. 查看 Claude 的日志以获取错误消息

安全说明

  • 您的 Up API 令牌授予对您的银行数据的完全读取权限
  • 切勿将令牌提交到版本控制中
  • 使用环境变量或安全配置管理
  • 您可以在 Up 应用中随时撤销令牌访问
  • 考虑为您的令牌设置到期日期

API 速率限制

Up API 有速率限制。如果超出限制，服务器将返回错误消息。使用分页和过滤来最小化 API 调用。

贡献

这是基本实现，涵盖主要的读操作。潜在增强功能：

  • 添加实时交易通知的 webhook 支持
  • 实现交易分类更新
  • 添加附件/收据支持
  • 支持基于游标的浏览分页

许可证

MIT

相关链接