Ramp Mcp : Un serveur Ramp Mcp

Qu'est-ce que ramp_mcp ?

Le ### ramp_mcp est un dépôt public hébergé sur GitHub sous l'organisation ### ramp-public. Ce dépôt est conçu pour faciliter diverses fonctionnalités liées à la gestion et au traitement des données, en particulier dans le contexte de l'augmentation des processus computationnels. Il sert de plateforme collaborative pour les développeurs et les contributeurs afin d'améliorer et de maintenir la base de code.

Fonctionnalités de ramp_mcp

• Open Source : Le dépôt est accessible au public, permettant à quiconque de consulter, d'utiliser et de contribuer au code.
• Collaboration : Il prend en charge plusieurs contributeurs, permettant le développement et l'amélioration collaboratifs du projet.
• Contrôle de Version : En utilisant Git, ramp_mcp maintient un historique des modifications, facilitant le suivi des modifications et le retour à des versions précédentes si nécessaire.
• Documentation : Une documentation complète est fournie pour aider les utilisateurs à comprendre les fonctionnalités et l'utilisation du dépôt.
• Licence : Le projet est sous licence MIT, promouvant la liberté d'utiliser, de modifier et de distribuer le logiciel.

Comment utiliser ramp_mcp

1. Cloner le Dépôt : Commencez par cloner le dépôt sur votre machine locale en utilisant la commande :

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

2. Installer les Dépendances : Naviguez vers le répertoire cloné et installez toutes les dépendances nécessaires comme indiqué dans la documentation.

3. Explorer le Code : Familiarisez-vous avec la structure et la fonctionnalité de la base de code. Des fichiers de documentation sont généralement inclus pour vous guider à travers les différents composants.

4. Contribuer : Si vous souhaitez contribuer, créez une nouvelle branche, apportez vos modifications et soumettez une demande de tirage pour révision.

5. Rester Informé : Suivez les mises à jour en surveillant le dépôt sur GitHub, ce qui vous notifiera de tout changement ou nouvelle version.

Questions Fréquemment Posées

Quels langages de programmation sont utilisés dans ramp_mcp ?

Le dépôt ramp_mcp utilise principalement des langages tels que Python et JavaScript, entre autres, en fonction des fonctionnalités spécifiques mises en œuvre.

Comment puis-je signaler des problèmes ou des bogues ?

Vous pouvez signaler des problèmes en naviguant vers l'onglet "Issues" dans le dépôt et en soumettant un nouveau problème avec une description détaillée du problème.

Existe-t-il une communauté pour ramp_mcp ?

Oui, la communauté peut être engagée à travers les discussions GitHub, les problèmes et les demandes de tirage. De plus, vous pouvez trouver des discussions sur des plateformes comme Slack ou Discord si elles sont mises en place par les mainteneurs.

Puis-je utiliser ramp_mcp dans mes propres projets ?

Absolument ! Étant donné qu'il est open-source et sous licence MIT, vous êtes libre d'utiliser, de modifier et de distribuer le code selon les termes de la licence.

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.