Ramp Mcp: 一個 Ramp Mcp 伺服器

什麼是 ramp_mcp？

ramp_mcp 是一個在 GitHub 上由 ### ramp-public 組織托管的公共代碼庫。這個代碼庫旨在促進與數據管理和處理相關的各種功能，特別是在提升計算過程的背景下。它作為一個協作平台，供開發者和貢獻者增強和維護代碼庫。

ramp_mcp 的特點

• 開源：該代碼庫是公開可訪問的，任何人都可以查看、使用和貢獻代碼。
• 協作：它支持多位貢獻者，促進項目的協作開發和改進。
• 版本控制：利用 Git，ramp_mcp 保持變更歷史，方便跟踪修改並在必要時恢復到以前的版本。
• 文檔：提供全面的文檔，以幫助用戶理解代碼庫的功能和用法。
• 授權：該項目根據 MIT 許可證授權，促進使用、修改和分發軟件的自由。

如何使用 ramp_mcp

1. 克隆代碼庫：首先使用以下命令將代碼庫克隆到本地機器：

   git clone https://github.com/ramp-public/ramp_mcp.git
   

2. 安裝依賴項：導航到克隆的目錄並根據文檔中的說明安裝任何必要的依賴項。

3. 探索代碼：熟悉代碼庫的結構和功能。通常會包含文檔文件以指導您了解各個組件。

4. 貢獻：如果您希望貢獻，請創建一個新分支，進行更改，然後提交拉取請求以供審查。

5. 保持更新：通過在 GitHub 上關注該代碼庫來跟踪更新，這將通知您任何變更或新版本的發布。

常見問題解答

ramp_mcp 使用了哪些編程語言？

ramp_mcp 代碼庫主要使用 Python 和 JavaScript 等語言，具體取決於實現的功能。

我該如何報告問題或錯誤？

您可以通過導航到代碼庫中的“問題”選項卡並提交一個詳細描述問題的新問題來報告問題。

ramp_mcp 有社區嗎？

是的，可以通過 GitHub 討論、問題和拉取請求參與社區。此外，如果維護者設置了，您還可以在 Slack 或 Discord 等平台上找到討論。

我可以在自己的項目中使用 ramp_mcp 嗎？

當然可以！由於它是開源的並且根據 MIT 許可證授權，您可以根據許可證的條款自由使用、修改和分發代碼。

ramp-mcp: A Ramp MCP server

Overview

A Model Context Protocol server for retrieving and analyzing data or running tasks for Ramp using Developer API. In order to get around token and input size limitations, this server implements a simple ETL pipeline + ephemeral sqlite database in memory for analysis by an LLM. All requests are made to demo by default, but can be changed by setting RAMP_ENV=prd. Large datasets may not be processable due to API and/or your MCP client limitations.

Tools

Database tools

Tools that can be used to setup, process, query, and delete an ephemeral database in memory.

1. process_data
2. execute_query
3. clear_table

Fetch tools

Tools that can be used to fetch data directly

1. get_ramp_categories
2. get_currencies

Load tools

Loads data to server which the client can fetch. Based on the tools you wish to use, ensure to enable those scopes on your Ramp client and include the scopes when starting the server as a CLI argument.

Tool	Scope
load_transactions	transactions:read
load_reimbursements	reimbursements:read
load_bills	bills:read
load_locations	locations:read
load_departments	departments:read
load_bank_accounts	bank_accounts:read
load_vendors	vendors:read
load_vendor_bank_accounts	vendors:read
load_entities	entities:read
load_spend_limits	limits:read
load_spend_programs	spend_programs:read
load_users	users:read

For large datasets, it is recommended to explicitly prompt Claude not to use REPL and to keep responses concise to avoid timeout or excessive token usage.

Setup

Ramp Setup

1. Create a new client from the Ramp developer page (Profile on top right > Developer > Create app)
2. Grant the scopes you wish (based on tools) to the client and enable client credentials (Click on App > Grant Types / Scopes)
3. Include the client ID and secret in the config file as well as the scopes you wish to use

Local Setup

1. Clone this Github repo via git clone git@github.com:ramp/ramp-mcp.git or equivalent
2. Install uv

Usage

Run the MCP server from your CLI with:

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

Configuration

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "ramp-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/<ABSOLUTE-PATH-TO>/ramp-mcp", // make sure to update this path
        "run",
        "ramp-mcp",
        "-s",
        "transactions:read,reimbursements:read"
      ],
      "env": {
        "RAMP_CLIENT_ID": "<CLIENT_ID>",
        "RAMP_CLIENT_SECRET": "<CLIENT_SECRET>",
        "RAMP_ENV": "<demo|qa|prd>"
      }
    }
  }
}

If this file doesn't exist yet, create one in /<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/

License

Copyright (c) 2025, Ramp Business Corporation All rights reserved. This source code is licensed under the MIT License found in the LICENSE file in the root directory of this source tree.