ramp-public
服务介绍
ramp-mcp: 一个 Ramp MCP 服务器
概述
这是一个用于通过 Developer API 获取和分析数据或为 Ramp 运行任务的 Model Context Protocol 服务器。为了绕过令牌和输入大小限制，该服务器实现了一个简单的 ETL 管道 + 内存中的临时 SQLite 数据库，以便 LLM 进行分析。所有请求默认发送到演示环境，但可以通过设置 RAMP_ENV=prd 更改。由于 API 和/或您的 MCP 客户端的限制，大型数据集可能无法处理。
工具
数据库工具
可以用来设置、处理、查询和删除内存中临时数据库的工具。
process_dataexecute_queryclear_table
获取工具
可以直接获取数据的工具。
get_ramp_categoriesget_currencies
加载工具
将数据加载到服务器上，客户端可以获取这些数据。根据您希望使用的工具，请确保在您的 Ramp 客户端上启用相应的范围，并在启动服务器时作为 CLI 参数包含这些范围。
| 工具 | 范围 |
|---|---|
| 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 |
对于大型数据集，建议明确提示 Claude 不要使用 REPL 并保持响应简洁，以避免超时或过度使用令牌。
设置
Ramp 设置
- 从 Ramp 开发者页面创建一个新的客户端（右上角的个人资料 > 开发者 > 创建应用）
- 授予客户端所需的范围（基于工具）并启用客户端凭据（点击应用 > 授权类型/范围）
- 在配置文件中包含客户端 ID 和密钥以及您希望使用的范围
本地设置
- 通过
git clone git@github.com:ramp/ramp-mcp.git或等效命令克隆此 GitHub 仓库 - 安装
uv
使用
从您的 CLI 运行 MCP 服务器：
bash
RAMP_CLIENT_ID=... RAMP_CLIENT_SECRET=... RAMP_ENV=<demo|prd> uv run ramp-mcp -s
配置
与 Claude Desktop 一起使用
将以下内容添加到您的 claude_desktop_config.json 文件中：
json
{
"mcpServers": {
"ramp-mcp": {
"command": "uv",
"args": [
"--directory",
"//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 Business Corporation
保留所有权利。
此源代码根据 MIT 许可证授权，在此源代码树的根目录下的 LICENSE 文件中可以找到该许可证。
