Ramp MCP

🚀 搭建 Ramp - MCP 服務器

本項目是一個用於檢索和分析數據或運行任務的模型上下文協議（MCP）服務器，藉助 Ramp 的 開發者 API 實現。為繞過令牌和輸入大小限制，該服務器實現了一個簡單的 ETL 管道，並結合內存中臨時 SQLite 數據庫進行分析，由大型語言模型（LLM）執行。所有請求默認在 demo 環境運行，但可通過設置 RAMP_ENV=prd 更改。不過，受 API 和/或您的 MCP 客戶端限制，可能無法處理大數據集。

🚀 快速開始

工具

數據庫工具

用於設置、處理、查詢和刪除內存中臨時數據庫的工具：

• process_data：處理數據
• execute_query：執行查詢
• clear_table：清除表

獲取工具

用於直接獲取數據的工具：

• get_ramp_categories：獲取 Ramp 分類
• get_currencies：獲取貨幣

加載工具

將數據加載到服務器，供客戶端獲取。根據您希望使用的工具，請確保在您的 Ramp 客戶端上啟用相應的作用域，並在啟動服務器時作為 CLI 參數包含這些作用域。

⚠️ 重要提示

對於大數據集，建議明確提示 Claude 不使用 REPL 並保持響應簡潔，以避免超時或過度的令牌使用。

設置

Ramp 設置

1. 從 Ramp 開發者頁面創建一個新的客戶端（頂部右側的個人資料 > 開發者 > 創建應用）
2. 授予您希望使用的權限（基於工具）到客戶端，並啟用客戶端憑據（點擊應用程序 > 權限/範圍）
3. 將客戶端 ID 和秘密包含在配置文件中，以及您希望使用的權限

本地設置

1. 使用 git clone git@github.com:ramp/ramp-mcp.git 或類似方式克隆此 Github 倉庫
2. 安裝 uv

使用方法

從您的 CLI 運行 MCP 服務器：

RAMP_CLIENT_ID=... RAMP_CLIENT_SECRET=... RAMP_ENV=<demo|prd> uv run ramp-mcp -s <COMMA-SEPARATED-SCOPES>

配置

與 Claude Desktop 使用

將以下內容添加到您的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "ramp-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/<ABSOLUTE-PATH-TO>/ramp-mcp", // 請根據實際情況更新此路徑
        "run",
        "ramp-mcp",
        "-s",
        "transactions:read,reimbursements:read"
      ],
      "env": {
        "RAMP_CLIENT_ID": "<CLIENT_ID>",
        "RAMP_CLIENT_SECRET": "<CLIENT_SECRET>",
        "RAMP_ENV": "<demo|qa|prd>"
      }
    }
  }
}

如果此文件尚不存在，請在 /<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/ 目錄下創建它。

📄 許可證

版權 © 2025, Ramp 商業公司 保留所有權利。 本源代碼根據 MIT 許可證發佈，許可證內容位於此源樹根目錄中的 LICENSE 文件中。