Ramp MCP

🚀 Ramp-MCP：一個Ramp MCP服務器

Ramp-MCP是一個模型上下文協議（Model Context Protocol）服務器，可通過Ramp的開發者API檢索和分析數據或運行任務。該服務器實現了簡單的ETL管道，利用內存中的臨時sqlite數據庫進行分析，以繞過令牌和輸入大小限制，供大語言模型（LLM）使用。默認請求發往演示環境，可通過設置RAMP_ENV=prd更改目標環境。不過，受API和/或MCP客戶端限制，大型數據集可能無法處理。

🚀 快速開始

工具

數據庫工具

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

1. process_data
2. execute_query
3. clear_table

獲取工具

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

1. get_ramp_categories
2. get_currencies

加載工具

將數據加載到服務器，供客戶端獲取。根據您希望使用的工具，確保在服務器啟動時啟用所需的範圍，並將其包含在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/下創建它。

📄 許可證

版權所有 (c) 2025, Ramp 商業公司 保留所有權利。 本源代碼根據LICENSE文件中找到的MIT許可證分發。