Ramp Mcp: Un Server Ramp Mcp
Panoramica
Cos'è ramp_mcp?
Il ### ramp_mcp è un repository pubblico ospitato su GitHub sotto l'organizzazione ### ramp-public. Questo repository è progettato per facilitare varie funzionalità relative alla gestione e all'elaborazione dei dati, in particolare nel contesto dell'aumento dei processi computazionali. Serve come piattaforma collaborativa per sviluppatori e collaboratori per migliorare e mantenere il codice sorgente.
Caratteristiche di ramp_mcp
- Open Source: Il repository è accessibile pubblicamente, consentendo a chiunque di visualizzare, utilizzare e contribuire al codice.
- Collaborazione: Supporta più collaboratori, consentendo lo sviluppo e il miglioramento collaborativo del progetto.
- Controllo Versione: Utilizzando Git, ramp_mcp mantiene una cronologia delle modifiche, rendendo facile tracciare le modifiche e tornare a versioni precedenti se necessario.
- Documentazione: È fornita una documentazione completa per assistere gli utenti nella comprensione delle funzionalità e dell'uso del repository.
- Licenza: Il progetto è concesso in licenza sotto la licenza MIT, promuovendo la libertà di utilizzare, modificare e distribuire il software.
Come utilizzare ramp_mcp
-
Clona il Repository: Inizia clonando il repository sulla tua macchina locale utilizzando il comando:
git clone https://github.com/ramp-public/ramp_mcp.git
-
Installa le Dipendenze: Naviga nella directory clonata e installa eventuali dipendenze necessarie come indicato nella documentazione.
-
Esplora il Codice: Familiarizza con la struttura e le funzionalità del codice sorgente. I file di documentazione sono tipicamente inclusi per guidarti attraverso i vari componenti.
-
Contribuisci: Se desideri contribuire, crea un nuovo ramo, apporta le tue modifiche e invia una richiesta di pull per la revisione.
-
Rimani Aggiornato: Tieni traccia degli aggiornamenti seguendo il repository su GitHub, che ti notificherà di eventuali modifiche o nuove versioni.
Domande Frequenti
Quali linguaggi di programmazione sono utilizzati in ramp_mcp?
Il repository ramp_mcp utilizza principalmente linguaggi come Python e JavaScript, tra gli altri, a seconda delle specifiche funzionalità implementate.
Come posso segnalare problemi o bug?
Puoi segnalare problemi navigando nella scheda "Issues" nel repository e inviando un nuovo problema con una descrizione dettagliata del problema.
Esiste una comunità per ramp_mcp?
Sì, la comunità può essere coinvolta attraverso le discussioni di GitHub, le issue e le pull request. Inoltre, puoi trovare discussioni su piattaforme come Slack o Discord se sono state impostate dai manutentori.
Posso utilizzare ramp_mcp nei miei progetti?
Assolutamente! Poiché è open-source e concesso in licenza sotto la licenza MIT, sei libero di utilizzare, modificare e distribuire il codice secondo i termini della licenza.
Dettaglio
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.
process_data
execute_query
clear_table
Fetch tools
Tools that can be used to fetch data directly
get_ramp_categories
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
- Create a new client from the Ramp developer page (Profile on top right > Developer > Create app)
- Grant the scopes you wish (based on tools) to the client and enable client credentials (Click on App > Grant Types / Scopes)
- Include the client ID and secret in the config file as well as the scopes you wish to use
Local Setup
- Clone this Github repo via
git clone git@github.com:ramp/ramp-mcp.git
or equivalent - 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.
Configurazione Server
{
"mcpServers": {
"ramp-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/metorial/mcp-container--ramp-public--ramp-mcp--ramp-mcp",
"ramp-mcp"
],
"env": {
"RAMP_CLIENT_ID": "ramp-client-id",
"RAMP_CLIENT_SECRET": "ramp-client-secret",
"RAMP_ENV": "ramp-env"
}
}
}
}