Ramp

官方

与Ramp的开发者API交互，对您的支出进行分析，并利用LLM获取洞察。

GitHub

你可以用 Ramp MCP 做什么？

加载财务数据到内存数据库 — 使用 load_transactions、load_bills、load_reimbursements 和其他加载工具将 Ramp 数据拉取到临时 SQLite 数据库中以供分析。
使用 SQL 查询已加载的数据 — 使用 execute_query 对内存数据库运行任意 SQL 查询，以过滤、聚合或连接已加载的数据集。
直接获取参考数据 — 通过 get_ramp_categories 和 get_currencies 检索 Ramp 类别和支持的货币，无需将其加载到数据库中。
管理临时数据库 — 使用 process_data 将原始 API 响应处理为可查询的表，并在完成后使用 clear_table 清除表。

文档

ramp-mcp：一个 Ramp MCP 服务器

概述

一个模型上下文协议服务器，用于通过 Developer API 检索和分析 Ramp 的数据或运行任务。为了解决令牌和输入大小的限制，该服务器实现了一个简单的 ETL 管道 + 内存中的临时 sqlite 数据库，供 LLM 进行分析。默认情况下，所有请求都发送到演示环境，但可以通过设置 RAMP_ENV=prd 进行更改。由于 API 和/或您的 MCP 客户端限制，大型数据集可能无法处理。

工具

数据库工具

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

process_data
execute_query
clear_table

获取工具

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

get_ramp_categories
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=<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/ 中创建一个