ramp-mcp: Ramp MCP サーバー

概要

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

ツール

データベースツール

メモリ内の一時データベースを設定、処理、クエリ、および削除するために使用できるツール。

1. process_data

2. execute_query

3. clear_table

フェッチツール

データを直接取得するために使用できるツール

1. get_ramp_categories

2. get_currencies

ツールをロードする

クライアントが取得できるデータをサーバーにロードします。使用するツールに応じて、Rampクライアントでこれらのスコープを有効にし、サーバーの起動時にCLI引数としてスコープを含めてください。

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

Related MCP server: Ramp MCP

設定

ランプのセットアップ

1. Ramp 開発者ページから新しいクライアントを作成します (右上のプロフィール > 開発者 > アプリの作成)

2. 必要なスコープ（ツールに基づいて）をクライアントに付与し、クライアントの資格情報を有効にします（[アプリ] > [付与タイプ/スコープ] をクリックします）。

3. 設定ファイルにクライアントIDとシークレット、および使用したいスコープを含めます。

ローカルセットアップ

1. この Github リポジトリgit clone git@github.com:ramp/ramp-mcp.gitまたは同等のコマンドでクローンします。

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ライセンスに基づいてライセンスされています。