🚀 Ramp-MCP：一个Ramp MCP服务器
Ramp-MCP是一个模型上下文协议（Model Context Protocol）服务器，可通过Ramp的开发者API检索和分析数据或运行任务。该服务器实现了简单的ETL管道，利用内存中的临时sqlite数据库进行分析，以绕过令牌和输入大小限制，供大语言模型（LLM）使用。默认请求发往演示环境，可通过设置RAMP_ENV=prd更改目标环境。不过，受API和/或MCP客户端限制，大型数据集可能无法处理。
🚀 快速开始
工具
数据库工具
用于设置、处理、查询和删除内存中临时数据库的工具：
process_dataexecute_queryclear_table
获取工具
用于直接获取数据的工具：
get_ramp_categoriesget_currencies
加载工具
将数据加载到服务器，供客户端获取。根据您希望使用的工具，确保在服务器启动时启用所需的范围，并将其包含在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服务器：
RAMP_CLIENT_ID=... RAMP_CLIENT_SECRET=... RAMP_ENV= uv run ramp-mcp -s
📚 详细文档
与Claude Desktop一起使用
将以下内容添加到您的claude_desktop_config.json文件中：
{
"mcpServers": {
"ramp-mcp": {
"command": "uv",
"args": [
"--directory",
"//ramp-mcp" , // 确保更新此路径
"run",
"ramp-mcp",
"-s",
"transactions:read,reimbursements:read"
],
"env": {
"RAMP_CLIENT_ID": "" ,
"RAMP_CLIENT_SECRET": "" ,
"RAMP_ENV": ""
}
}
}
}
如果文件尚不存在，请在/下创建它。
📄 许可证
版权所有 (c) 2025, Ramp 商业公司 保留所有权利。 本源代码根据LICENSE文件中找到的MIT许可证分发。