Ramp MCP服务器

一个用于通过开发者API检索、分析数据或运行任务的模型上下文协议服务器,适用于金融数据分析和处理场景。

  • by ramp-public
  • Python
  • 本地部署
  • 34 星标
  • 更新于
在 GitHub 查看 ramp-public/ramp_mcp

使用说明

ramp-mcp:ramp-mcp服务器

概述

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

工具

数据库工具

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

  1. process_data
  2. execute_query
  3. clear_table

获取工具

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

  1. get_ramp_categories
  2. get_currencies

加载工具

将数据加载到客户端可以获取的服务器。根据您希望使用的工具,确保在您的 Ramp客户端,并在启动服务器时将作用域作为CLI参数包含在内。

工具 范围
load_transactions 事务:读取
load_repayments 报销:阅读
load_bills bills:阅读
load_locations 位置:读取
load_departs 部门:阅读
load_bank_accons bank_accons:读取
load_venders 供应商:阅读
load_vendor_bank_accounts 供应商:读取
load_entities 实体:读取
load_spend_limits 限制:读取
load_spend_programs spend_programs:读取
load_users 用户:阅读

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

设置

坡道设置

  1. 从Ramp开发人员页面创建新客户端(右上角的配置文件>开发人员>创建应用程序)
  2. 将您希望的范围(基于工具)授予客户端并启用客户端凭据(单击应用程序>授予类型/范围)
  3. 在配置文件中包括客户端ID和密码以及要使用的作用域

本地设置

  1. 通过以下方式克隆此Github仓库 git clone git@github.com:ramp/ramp-mcp.git 或同等物
  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", // 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 Business Corporation版权所有(c)2025 保留所有权利。 此源代码根据此源代码树根目录中的License文件中的MIT许可证进行许可。