使用说明
ramp-mcp:ramp-mcp服务器
概述
用于检索和分析数据或运行任务的模型上下文协议服务器 斜坡 使用 开发者API为了绕过令牌和输入大小的限制,该服务器在内存中实现了一个简单的ETL管道+临时sqlite数据库,供LLM分析。默认情况下,所有请求都是向演示发出的,但可以通过设置进行更改 RAMP_ENV=prd.由于API和/或MCP客户端的限制,大型数据集可能无法处理。
工具
数据库工具
可用于在内存中设置、处理、查询和删除临时数据库的工具。
process_dataexecute_queryclear_table
获取工具
可用于直接获取数据的工具
get_ramp_categoriesget_currencies
加载工具
将数据加载到客户端可以获取的服务器。根据您希望使用的工具,确保在您的 Ramp客户端,并在启动服务器时将作用域作为CLI参数包含在内。
| 工具 | 范围 |
|---|---|
| load_transactions | 事务:读取 |
| load_repayments | 报销:阅读 |
| load_bills | bills:阅读 |
| load_locations | 位置:读取 |
| load_departs | 部门:阅读 |
| load_bank_accons | bank_accons:读取 |
| load_venders | 供应商:阅读 |
| load_vendor_bank_accounts | 供应商:读取 |
| load_entities | 实体:读取 |
| load_spend_limits | 限制:读取 |
| load_spend_programs | spend_programs:读取 |
| load_users | 用户:阅读 |
对于大型数据集,建议明确提示Claude不要使用REPL,并保持响应简洁,以避免超时或过度使用令牌。
设置
坡道设置
- 从Ramp开发人员页面创建新客户端(右上角的配置文件>开发人员>创建应用程序)
- 将您希望的范围(基于工具)授予客户端并启用客户端凭据(单击应用程序>授予类型/范围)
- 在配置文件中包括客户端ID和密码以及要使用的作用域
本地设置
- 通过以下方式克隆此Github仓库
git clone git@github.com:ramp/ramp-mcp.git或同等物 - 安装
uv
用法
使用以下命令从CLI运行MCP服务器:
RAMP_CLIENT_ID=... RAMP_CLIENT_SECRET=... RAMP_ENV=<demo|prd> uv run ramp-mcp -s <COMMA-SEPARATED-SCOPES>
配置
使用Claude Desktop
将此添加到您的 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>"
}
}
}
}
如果此文件尚不存在,请在中创建一个 /<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/
许可证
Ramp Business Corporation版权所有(c)2025 保留所有权利。 此源代码根据此源代码树根目录中的License文件中的MIT许可证进行许可。