Ramp Mcp: ランプMcpサーバー

ramp_mcpとは？

ramp_mcpは、### ramp-publicという組織の下でGitHubにホストされている公開リポジトリです。このリポジトリは、特に計算プロセスの立ち上げに関連するデータの管理と処理に関するさまざまな機能を促進するために設計されています。開発者や貢献者がコードベースを強化し、維持するための協力的なプラットフォームとして機能します。

ramp_mcpの特徴

• オープンソース：リポジトリは公開されており、誰でもコードを閲覧、使用、貢献することができます。
• コラボレーション：複数の貢献者をサポートし、プロジェクトの共同開発と改善を可能にします。
• バージョン管理：Gitを利用して、ramp_mcpは変更の履歴を保持し、修正を追跡したり、必要に応じて以前のバージョンに戻したりすることが容易です。
• ドキュメント：リポジトリの機能や使用方法を理解するための包括的なドキュメントが提供されています。
• ライセンス：プロジェクトはMITライセンスの下でライセンスされており、ソフトウェアの使用、変更、配布の自由を促進しています。

ramp_mcpの使用方法

1. リポジトリをクローンする：次のコマンドを使用して、リポジトリをローカルマシンにクローンします。

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

2. 依存関係をインストールする：クローンしたディレクトリに移動し、ドキュメントに記載されている必要な依存関係をインストールします。

3. コードを探索する：コードベースの構造と機能に慣れましょう。さまざまなコンポーネントをガイドするためのドキュメントファイルが通常含まれています。

4. 貢献する：貢献したい場合は、新しいブランチを作成し、変更を加え、レビューのためにプルリクエストを提出します。

5. 更新を追跡する：GitHubでリポジトリをウォッチして、変更や新しいリリースの通知を受け取ります。

よくある質問

ramp_mcpで使用されているプログラミング言語は何ですか？

ramp_mcpリポジトリは、主にPythonやJavaScriptなどの言語を利用しており、実装される特定の機能に応じて異なります。

問題やバグを報告するにはどうすればよいですか？

リポジトリの「Issues」タブに移動し、問題の詳細な説明を含む新しいイシューを提出することで報告できます。

ramp_mcpのコミュニティはありますか？

はい、コミュニティはGitHubのディスカッション、イシュー、プルリクエストを通じて参加できます。また、メンテナーによって設定されている場合、SlackやDiscordなどのプラットフォームでのディスカッションも見つけることができます。

自分のプロジェクトでramp_mcpを使用できますか？

もちろんです！オープンソースでMITライセンスの下でライセンスされているため、ライセンスの条件に従ってコードを使用、変更、配布する自由があります。

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.