🚀 搭建 Ramp - MCP 服务器
本项目是一个用于检索和分析数据或运行任务的模型上下文协议（MCP）服务器，借助 Ramp 的 开发者 API 实现。为绕过令牌和输入大小限制，该服务器实现了一个简单的 ETL 管道，并结合内存中临时 SQLite 数据库进行分析，由大型语言模型（LLM）执行。所有请求默认在 demo 环境运行，但可通过设置 RAMP_ENV=prd 更改。不过，受 API 和/或您的 MCP 客户端限制，可能无法处理大数据集。
🚀 快速开始
工具
数据库工具
用于设置、处理、查询和删除内存中临时数据库的工具：
- process_data：处理数据
- execute_query：执行查询
- clear_table：清除表
获取工具
用于直接获取数据的工具：
- get_ramp_categories：获取 Ramp 分类
- get_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 服务器：
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": ""
}
}
}
}
如果此文件尚不存在，请在 / 目录下创建它。
📄 许可证
版权 © 2025, Ramp 商业公司 保留所有权利。 本源代码根据 MIT 许可证发布，许可证内容位于此源树根目录中的 LICENSE 文件中。