Ramp Mcp: 一個 Ramp Mcp 伺服器

什麼是 ramp_mcp？

ramp_mcp 儲存庫是一個在 GitHub 上由 ### ramp-public 組織主辦的公共項目。這個儲存庫作為開發者協作的平台，讓他們能夠為項目做出貢獻、分享代碼和追蹤變更。它旨在促進各種功能和特性的開發，這些功能和特性可以在不同的應用程序中使用。

ramp_mcp 的特點

• 開源：ramp_mcp 儲存庫是公開可訪問的，任何人都可以查看、分叉和為該項目做出貢獻。
• 版本控制：利用 Git，儲存庫保持變更歷史，讓開發者能夠追蹤修改並有效協作。
• 社區參與：用戶可以為儲存庫點贊以表示支持，分叉它以創建自己的版本，並提交問題或拉取請求以貢獻改進。
• 文檔：提供全面的文檔，幫助用戶了解如何使用和為項目做出貢獻。

如何使用 ramp_mcp

1. 訪問儲存庫：訪問 ramp_mcp GitHub 頁面 以探索該項目。
2. 克隆儲存庫：使用命令 git clone https://github.com/ramp-public/ramp_mcp.git 創建儲存庫的本地副本。
3. 探索代碼：瀏覽各種文件和目錄，以了解項目的結構和功能。
4. 貢獻：如果您希望貢獻，可以分叉儲存庫，進行更改，並提交拉取請求以供審查。
5. 保持更新：關注儲存庫以接收有關更新和變更的通知。

常見問題解答

ramp_mcp 使用了哪些編程語言？

ramp_mcp 儲存庫可能根據項目的需求使用多種編程語言。常見的語言包括 Python、JavaScript 等。

我該如何報告問題？

您可以通過導航到儲存庫頁面上的「問題」標籤並點擊「新問題」來報告問題。提供詳細的問題描述，以幫助維護者有效解決。

我可以為 ramp_mcp 做出貢獻嗎？

當然可以！歡迎貢獻。您可以分叉儲存庫，進行更改，並提交拉取請求以供審查。

ramp_mcp 有許可證嗎？

是的，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.