JinDaGe - ramp_mcp MCP Details

article

README

🚀 搭建 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=<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/ 目录下创建它。

ramp_mcp