🚀 搭建 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 参数包含这些作用域。

⚠️ 重要提示

对于大数据集，建议明确提示 Claude 不使用 REPL 并保持响应简洁，以避免超时或过度的令牌使用。

设置

Ramp 设置

1. 从 Ramp 开发者页面创建一个新的客户端（顶部右侧的个人资料 > 开发者 > 创建应用）
2. 授予您希望使用的权限（基于工具）到客户端，并启用客户端凭据（点击应用程序 > 权限/范围）
3. 将客户端 ID 和秘密包含在配置文件中，以及您希望使用的权限

本地设置

1. 使用 git clone git@github.com:ramp/ramp-mcp.git 或类似方式克隆此 Github 仓库
2. 安装 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", // 请根据实际情况更新此路径
        "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/ 目录下创建它。

📄 许可证

版权 © 2025, Ramp 商业公司 保留所有权利。 本源代码根据 MIT 许可证发布，许可证内容位于此源树根目录中的 LICENSE 文件中。