Ramp MCP Server

ramp-mcp : Un serveur MCP Ramp

Aperçu

Un serveur Model Context Protocol pour récupérer et analyser des données ou exécuter des tâches pour Ramp en utilisant l'API Développeur. Afin de contourner les limitations de jetons et de taille d'entrée, ce serveur implémente un pipeline ETL simple ainsi qu'une base de données sqlite éphémère en mémoire pour l'analyse par un LLM. Toutes les requêtes sont effectuées vers la démo par défaut, mais cela peut être modifié en définissant RAMP_ENV=prd. Les jeux de données volumineux peuvent ne pas être traitables en raison des limitations de l'API et/ou de votre client MCP.

Outils

Outils de base de données

Outils pouvant être utilisés pour configurer, traiter, interroger et supprimer une base de données éphémère en mémoire.

1. process_data
2. execute_query
3. clear_table

Outils de récupération

Outils pouvant être utilisés pour récupérer des données directement

1. get_ramp_categories
2. get_currencies

Outils de chargement

Charge les données sur le serveur que le client peut récupérer. Selon les outils que vous souhaitez utiliser, assurez-vous d'activer ces portées sur votre client Ramp et d'inclure les portées lors du démarrage du serveur en tant qu'argument CLI.

Outil	Portée
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

Pour les jeux de données volumineux, il est recommandé de demander explicitement à Claude de ne pas utiliser REPL et de garder les réponses concises afin d'éviter les délais d'attente ou une utilisation excessive de jetons.

Configuration

Configuration de Ramp

1. Créez un nouveau client depuis la page développeur Ramp (Profil en haut à droite > Développeur > Créer une application)
2. Accordez les portées souhaitées (selon les outils) au client et activez les identifiants client (Cliquez sur App > Types d'octroi / Portées)
3. Incluez l'ID client et le secret dans le fichier de configuration ainsi que les portées que vous souhaitez utiliser

Configuration locale

1. Clonez ce dépôt Github via git clone [email protected]:ramp/ramp-mcp.git ou équivalent
2. Installez uv

Utilisation

Exécutez le serveur MCP depuis votre CLI avec :

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

Configuration

Utilisation avec Claude Desktop

Ajoutez ceci à votre 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>"
      }
    }
  }
}

Si ce fichier n'existe pas encore, créez-en un dans /<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/

Licence

Copyright (c) 2025, Ramp Business Corporation Tous droits réservés. Ce code source est sous licence MIT, telle que décrite dans le fichier LICENSE à la racine de ce dépôt.