ramp-mcp：Ramp MCP 服务器

概述

一个模型上下文协议 (MCP) 服务器，用于使用开发者 API检索和分析数据或运行Ramp任务。为了规避 token 和输入大小的限制，该服务器在内存中实现了一个简单的 ETL 管道 + 临时 SQLite 数据库，供 LLM 进行分析。所有请求默认都发送到 demo，但可以通过设置RAMP_ENV=prd进行更改。由于 API 和/或您的 MCP 客户端限制，大型数据集可能无法处理。

工具

数据库工具

可用于设置、处理、查询和删除内存中的临时数据库的工具。

process_data
execute_query
clear_table

获取工具

可用于直接获取数据的工具

get_ramp_categories
get_currencies

加载工具

将数据加载到客户端可以获取的服务器。根据您想要使用的工具，请确保在 Ramp 客户端上启用相应的作用域，并在启动服务器时将这些作用域作为 CLI 参数包含进去。

工具	范围
加载交易	交易：读取
负载补偿	报销：阅读
加载账单	账单：已读
加载位置	地点：阅读
加载部门	部门：阅读
加载银行账户	银行账户：读取
加载供应商	供应商：阅读
加载供应商银行账户	供应商：阅读
加载实体	实体：读取
负载支出限额	限制：读取
加载支出程序	花费程序：阅读
加载用户	用户：阅读

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

设置

坡道设置

从 Ramp 开发者页面创建新客户端（右上角的个人资料 > 开发者 > 创建应用程序）
向客户端授予您希望的范围（基于工具）并启用客户端凭据（单击应用程序>授予类型/范围）
在配置文件中包含客户端 ID 和密钥以及您希望使用的范围

本地设置

通过git clone git@github.com:ramp/ramp-mcp.git或等效方法克隆此 Github 仓库
安装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 MCP Server

Integrations