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.