ramp-public
服务介绍
ramp-mcp: 一个Ramp MCP服务器
概述
这是一个用于从Ramp检索和分析数据或执行任务的模型上下文协议（Model Context Protocol, MCP）服务器，通过开发者API实现。为了绕过令牌和输入大小限制，该服务器实现了一个简单的ETL管道+内存中的临时SQLite数据库供大型语言模型（LLM）进行分析。默认情况下所有请求都是针对演示环境发起的，但可以通过设置RAMP_ENV=prd来更改。由于API和/或您的MCP客户端的限制，可能无法处理大型数据集。
工具
数据库工具
这些工具可用于设置、处理、查询以及删除内存中的临时数据库。
process_dataexecute_queryclear_table
获取工具
这些工具可以直接用来获取数据。
get_ramp_categoriesget_currencies
加载工具
将数据加载到服务器上，以便客户端可以获取。根据您希望使用的工具，请确保在您的Ramp客户端上启用相应的范围，并在启动服务器时作为命令行参数包含这些范围。
| 工具 | 范围 |
|---|---|
| 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桌面版一起使用
将以下内容添加到您的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文件中可以找到该许可证。
