Ramp Mcp: Un Server Ramp Mcp

Cos'è ramp_mcp?

Il ### repository ramp_mcp è un progetto pubblico ospitato su GitHub sotto l'organizzazione ### ramp-public. Questo repository funge da piattaforma collaborativa per gli sviluppatori per contribuire al progetto, condividere codice e tenere traccia delle modifiche. È progettato per facilitare lo sviluppo di varie funzionalità e caratteristiche che possono essere utilizzate in diverse applicazioni.

Caratteristiche di ramp_mcp

• Open Source: Il repository ramp_mcp è accessibile pubblicamente, consentendo a chiunque di visualizzare, forkare e contribuire al progetto.
• Controllo Versione: Utilizzando Git, il repository mantiene una cronologia delle modifiche, consentendo agli sviluppatori di tenere traccia delle modifiche e collaborare in modo efficace.
• Coinvolgimento della Comunità: Gli utenti possono mettere una stella al repository per mostrare supporto, forkare per creare le proprie versioni e inviare problemi o richieste di pull per contribuire a miglioramenti.
• Documentazione: È fornita una documentazione completa per aiutare gli utenti a capire come utilizzare e contribuire al progetto.

Come utilizzare ramp_mcp

1. Accedi al Repository: Visita la pagina GitHub di ramp_mcp per esplorare il progetto.
2. Clona il Repository: Usa il comando git clone https://github.com/ramp-public/ramp_mcp.git per creare una copia locale del repository.
3. Esplora il Codice: Naviga tra i vari file e directory per comprendere la struttura e la funzionalità del progetto.
4. Contribuisci: Se desideri contribuire, puoi forkare il repository, apportare le tue modifiche e inviare una richiesta di pull per la revisione.
5. Rimani Aggiornato: Segui il repository per ricevere notifiche su aggiornamenti e modifiche.

Domande Frequenti

Quali linguaggi di programmazione sono utilizzati in ramp_mcp?

Il repository ramp_mcp può utilizzare più linguaggi di programmazione, a seconda delle esigenze del progetto. I linguaggi comuni includono Python, JavaScript e altri.

Come posso segnalare un problema?

Puoi segnalare problemi navigando nella scheda "Issues" sulla pagina del repository e cliccando su "New Issue." Fornisci una descrizione dettagliata del problema per aiutare i manutentori a risolverlo efficacemente.

Posso contribuire a ramp_mcp?

Assolutamente! I contributi sono benvenuti. Puoi forkare il repository, apportare modifiche e inviare una richiesta di pull per la revisione.

Esiste una licenza per ramp_mcp?

Sì, il repository ramp_mcp è concesso in licenza sotto la licenza MIT, che consente l'uso, la modifica e la distribuzione gratuita del codice.

Come posso rimanere aggiornato sulle modifiche al progetto?

Puoi mettere una stella al repository o seguirlo per ricevere notifiche su aggiornamenti, nuove versioni e discussioni relative al progetto.

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.