Ramp Mcp: Um Servidor Ramp Mcp

O que é ramp_mcp?

O ### repositório ramp_mcp é um projeto público hospedado no GitHub sob a organização ### ramp-public. Este repositório serve como uma plataforma colaborativa para desenvolvedores contribuírem para o projeto, compartilharem código e acompanharem mudanças. Ele é projetado para facilitar o desenvolvimento de várias funcionalidades que podem ser utilizadas em diferentes aplicações.

Recursos do ramp_mcp

• Código Aberto: O repositório ramp_mcp é acessível publicamente, permitindo que qualquer pessoa visualize, faça fork e contribua para o projeto.
• Controle de Versão: Utilizando o Git, o repositório mantém um histórico de mudanças, permitindo que os desenvolvedores acompanhem modificações e colaborem de forma eficaz.
• Engajamento da Comunidade: Os usuários podem dar estrelas ao repositório para mostrar apoio, fazer fork para criar suas próprias versões e enviar problemas ou pull requests para contribuir com melhorias.
• Documentação: Documentação abrangente é fornecida para ajudar os usuários a entender como usar e contribuir para o projeto.

Como Usar o ramp_mcp

1. Acesse o Repositório: Visite a página do GitHub do ramp_mcp para explorar o projeto.
2. Clone o Repositório: Use o comando git clone https://github.com/ramp-public/ramp_mcp.git para criar uma cópia local do repositório.
3. Explore o Código: Navegue pelos vários arquivos e diretórios para entender a estrutura e a funcionalidade do projeto.
4. Contribua: Se você deseja contribuir, pode fazer um fork do repositório, fazer suas alterações e enviar um pull request para revisão.
5. Mantenha-se Atualizado: Siga o repositório para receber notificações sobre atualizações e mudanças.

Perguntas Frequentes

Quais linguagens de programação são usadas no ramp_mcp?

O repositório ramp_mcp pode utilizar várias linguagens de programação, dependendo dos requisitos do projeto. Linguagens comuns incluem Python, JavaScript e outras.

Como posso relatar um problema?

Você pode relatar problemas navegando até a aba "Issues" na página do repositório e clicando em "New Issue." Forneça uma descrição detalhada do problema para ajudar os mantenedores a resolvê-lo de forma eficaz.

Posso contribuir para o ramp_mcp?

Absolutamente! Contribuições são bem-vindas. Você pode fazer um fork do repositório, fazer alterações e enviar um pull request para revisão.

Existe uma licença para o ramp_mcp?

Sim, o repositório ramp_mcp é licenciado sob a licença MIT, que permite o uso, modificação e distribuição gratuita do código.

Como posso me manter atualizado sobre as mudanças no projeto?

Você pode dar estrelas ao repositório ou segui-lo para receber notificações sobre atualizações, novas versões e discussões relacionadas ao projeto.

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.