Up Bank MCP Server

🚀 Up Banking MCP Server

Up Banking MCP Server是一個模型上下文協議（MCP）服務器，可與Up Banking API集成。該服務器允許Claude與你的Up銀行數據進行交互，涵蓋賬戶、交易和類別等信息。

🚀 快速開始

本項目可讓你使用Claude與Up銀行數據交互，你需要完成安裝和配置步驟，才能開始使用。

✨ 主要特性

• 賬戶管理：列出所有賬戶，獲取賬戶詳細信息和餘額。
• 交易歷史：通過靈活的過濾條件（日期範圍、狀態、類別、標籤）查詢交易記錄。
• 類別信息：訪問Up的消費類別，以便更好地洞察交易情況。
• 類型安全：使用TypeScript構建，確保可靠性和開發體驗。
• 安全可靠：使用Up的個人訪問令牌進行身份驗證。

📦 安裝指南

安裝前提

• Node.js 18 或更高版本
• 擁有Up銀行賬戶
• 獲取Up個人訪問令牌

安裝步驟

1. 克隆或下載此倉庫：

cd up-mcp-server

2. 安裝依賴項：

npm install

3. 構建服務器：

npm run build

💻 使用示例

基礎用法

配置完成後，你可以向Claude詢問以下問題：

• "我的當前賬戶餘額是多少？"
• "顯示我上個月的所有交易記錄。"
• "我本週在餐廳消費了多少？"
• "列出我所有的儲蓄賬戶。"
• "我的消費賬戶中有哪些待處理的交易？"
• "顯示所有標記為'度假'的交易記錄。"

📚 詳細文檔

獲取Up API令牌

1. 打開手機上的Up應用。
2. 向右滑動並選擇“數據共享”。
3. 點擊“個人訪問令牌”。
4. 選擇“生成令牌”。
5. 選擇令牌的有效期。
6. 按照提示操作，並安全地複製你的令牌。

重要提示：請妥善保管你的令牌！切勿分享或提交到版本控制系統。

配置

Claude桌面配置

將以下內容添加到你的Claude桌面配置文件中：

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

{
  "mcpServers": {
    "up-banking": {
      "command": "node",
      "args": ["/absolute/path/to/up-mcp-server/build/index.js"],
      "env": {
        "UP_API_TOKEN": "your_up_api_token_here"
      }
    }
  }
}

將/absolute/path/to/up-mcp-server替換為該目錄的實際路徑，並將your_up_api_token_here替換為你的Up個人訪問令牌。

替代方法：使用npx

你也可以直接使用npx運行服務器：

{
  "mcpServers": {
    "up-banking": {
      "command": "npx",
      "args": ["-y", "/absolute/path/to/up-mcp-server"],
      "env": {
        "UP_API_TOKEN": "your_up_api_token_here"
      }
    }
  }
}

可用工具

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”）。

開發

監聽模式

在開發過程中實現自動重新編譯：

npm run dev

測試連接

配置完成後，重啟Claude桌面並嘗試以下操作：

Can you ping the Up API to verify the connection?

故障排除

"UP_API_TOKEN environment variable is required"

確保你已將Up API令牌添加到Claude桌面配置的env部分。

"Up API error: 401"

你的API令牌無效或已過期。在Up應用中生成新的令牌。

服務器未在Claude中顯示

1. 檢查build/index.js的路徑是否為絕對路徑且正確。
2. 驗證配置文件中的JSON語法是否有效。
3. 完全重啟Claude桌面。
4. 檢查Claude的日誌以獲取錯誤消息。

安全注意事項

• 你的Up API令牌可對銀行數據進行完全讀取訪問。
• 切勿將令牌提交到版本控制系統。
• 使用環境變量或安全的配置管理。
• 可以隨時在Up應用中撤銷令牌訪問權限。
• 考慮為令牌設置過期日期。

API速率限制

Up API有速率限制。如果超過限制，服務器將返回錯誤消息。使用分頁和過濾功能以減少API調用次數。

貢獻

這是一個涵蓋主要讀取操作的基本實現。潛在的增強功能包括：

• 添加Webhook支持，實現即時交易通知。
• 實現交易分類更新。
• 添加附件/收據支持。
• 支持基於遊標瀏覽的分頁功能。

📄 許可證

本項目採用MIT許可證。

相關鏈接

• Up Banking API文檔
• 模型上下文協議文檔
• Up Bank