Ramp Mcp: Un Servidor Ramp Mcp

¿Qué es ramp_mcp?

El ### ramp_mcp es un repositorio público alojado en GitHub bajo la organización ### ramp-public. Este repositorio está diseñado para facilitar diversas funcionalidades relacionadas con la gestión y procesamiento de datos, particularmente en el contexto de aumentar los procesos computacionales. Sirve como una plataforma colaborativa para desarrolladores y contribuyentes para mejorar y mantener la base de código.

Características de ramp_mcp

• Código Abierto: El repositorio es accesible públicamente, permitiendo a cualquier persona ver, usar y contribuir al código.
• Colaboración: Soporta múltiples contribuyentes, permitiendo el desarrollo colaborativo y la mejora del proyecto.
• Control de Versiones: Utilizando Git, ramp_mcp mantiene un historial de cambios, facilitando el seguimiento de modificaciones y la reversión a versiones anteriores si es necesario.
• Documentación: Se proporciona documentación completa para ayudar a los usuarios a entender las funcionalidades y el uso del repositorio.
• Licencia: El proyecto está licenciado bajo la licencia MIT, promoviendo la libertad de usar, modificar y distribuir el software.

Cómo Usar ramp_mcp

1. Clonar el Repositorio: Comienza clonando el repositorio en tu máquina local usando el comando:

   git clone https://github.com/ramp-public/ramp_mcp.git
   

2. Instalar Dependencias: Navega al directorio clonado e instala las dependencias necesarias según lo indicado en la documentación.

3. Explorar el Código: Familiarízate con la estructura y funcionalidad de la base de código. Los archivos de documentación suelen estar incluidos para guiarte a través de los diversos componentes.

4. Contribuir: Si deseas contribuir, crea una nueva rama, realiza tus cambios y envía una solicitud de extracción para revisión.

5. Mantente Actualizado: Mantén un seguimiento de las actualizaciones observando el repositorio en GitHub, lo que te notificará sobre cualquier cambio o nuevas versiones.

Preguntas Frecuentes

¿Qué lenguajes de programación se utilizan en ramp_mcp?

El repositorio ramp_mcp utiliza principalmente lenguajes como Python y JavaScript, entre otros, dependiendo de las funcionalidades específicas que se estén implementando.

¿Cómo puedo reportar problemas o errores?

Puedes reportar problemas navegando a la pestaña "Issues" en el repositorio y enviando un nuevo problema con una descripción detallada del problema.

¿Hay una comunidad para ramp_mcp?

Sí, la comunidad se puede involucrar a través de discusiones en GitHub, problemas y solicitudes de extracción. Además, puedes encontrar discusiones en plataformas como Slack o Discord si están configuradas por los mantenedores.

¿Puedo usar ramp_mcp en mis propios proyectos?

¡Absolutamente! Dado que es de código abierto y está licenciado bajo la licencia MIT, eres libre de usar, modificar y distribuir el código según los términos de la licencia.

ramp-mcp: A Ramp MCP server

Overview

A Model Context Protocol server for retrieving and analyzing data or running tasks for Ramp using Developer API. In order to get around token and input size limitations, this server implements a simple ETL pipeline + ephemeral sqlite database in memory for analysis by an LLM. All requests are made to demo by default, but can be changed by setting RAMP_ENV=prd. Large datasets may not be processable due to API and/or your MCP client limitations.

Tools

Database tools

Tools that can be used to setup, process, query, and delete an ephemeral database in memory.

1. process_data
2. execute_query
3. clear_table

Fetch tools

Tools that can be used to fetch data directly

1. get_ramp_categories
2. get_currencies

Load tools

Loads data to server which the client can fetch. Based on the tools you wish to use, ensure to enable those scopes on your Ramp client and include the scopes when starting the server as a CLI argument.

Tool	Scope
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

For large datasets, it is recommended to explicitly prompt Claude not to use REPL and to keep responses concise to avoid timeout or excessive token usage.

Setup

Ramp Setup

1. Create a new client from the Ramp developer page (Profile on top right > Developer > Create app)
2. Grant the scopes you wish (based on tools) to the client and enable client credentials (Click on App > Grant Types / Scopes)
3. Include the client ID and secret in the config file as well as the scopes you wish to use

Local Setup

1. Clone this Github repo via git clone git@github.com:ramp/ramp-mcp.git or equivalent
2. Install uv

Usage

Run the MCP server from your CLI with:

RAMP_CLIENT_ID=... RAMP_CLIENT_SECRET=... RAMP_ENV=<demo|prd> uv run ramp-mcp -s <COMMA-SEPARATED-SCOPES>

Configuration

Usage with Claude Desktop

Add this to your 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>"
      }
    }
  }
}

If this file doesn't exist yet, create one in /<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/

License

Copyright (c) 2025, Ramp Business Corporation All rights reserved. This source code is licensed under the MIT License found in the LICENSE file in the root directory of this source tree.