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.