ramp-mcp: A Ramp MCP server

ramp-mcp：Ramp MCP サーバー

概要

Developer API を使用して、Ramp のデータを取得・分析したり、タスクを実行したりするための Model Context Protocol サーバーです。トークン数と入力サイズの制限を回避するため、このサーバーはシンプルな ETL パイプラインと、LLM による分析用のメモリ内一時的な sqlite データベースを実装しています。すべてのリクエストはデフォルトでデモ環境に送信されますが、RAMP_ENV=prd を設定することで変更できます。API や MCP クライアントの制限により、大規模なデータセットを処理できない場合があります。

ツール

データベースツール

メモリ内の一時的なデータベースの設定、処理、クエリ、削除に使用できるツールです。

1. process_data
2. execute_query
3. clear_table

取得ツール

データを直接取得するためのツールです。

1. get_ramp_categories
2. get_currencies

読み込みツール

クライアントが取得できるよう、データをサーバーに読み込みます。使用するツールに応じて、Ramp クライアントで該当するスコープを有効にし、サーバーの起動時に CLI 引数としてスコープを指定してください。

ツール	スコープ
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

大規模なデータセットの場合、タイムアウトや過剰なトークン使用を避けるため、Claude に REPL を使用しないよう明示的に指示し、応答を簡潔にすることをおすすめします。

セットアップ

Ramp のセットアップ

1. Ramp の開発者ページから新しいクライアントを作成します（右上のプロフィール > Developer > Create app）。
2. クライアントに必要なスコープを付与し、クライアント認証情報を有効にします（App > Grant Types / Scopes をクリック）。
3. クライアント ID とシークレット、および使用するスコープを設定ファイルに記載します。

ローカルセットアップ

1. git clone [email protected]:ramp/ramp-mcp.git または同等のコマンドで、この Github リポジトリをクローンします。
2. uv をインストールします。

使用方法

次のコマンドで CLI から MCP サーバーを起動します。

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

設定

Claude Desktop での使用方法

以下を 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>"
      }
    }
  }
}

このファイルがまだ存在しない場合は、/<ABSOLUTE-PATH-TO>/Library/Application Support/Claude/ に作成してください。

ライセンス

Copyright (c) 2025, Ramp Business Corporation
All rights reserved.
このソースコードは、ソースツリーのルートディレクトリにある LICENSE ファイルに記載された MIT License のもとでライセンスされています。