Ramp MCP

🚀 Ramp - MCPサーバーの構築

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

🚀 クイックスタート

このセクションでは、Ramp - MCPサーバーのクイックスタートについて説明します。

セットアップ

Rampセットアップ

1. Ramp開発者ページから新しいクライアントを作成します（右上のプロフィール > 開発者 > アプリケーションを作成）。
2. 使用するツールに基づいて、クライアントに必要な権限を付与し、クライアント認証情報を有効にします（アプリケーションをクリック > 権限/スコープ）。
3. クライアントIDとシークレットを設定ファイルに含め、使用する権限を指定します。

ローカルセットアップ

1. git clone git@github.com: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", // 実際のパスに更新してください
        "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/ ディレクトリに作成してください。

✨ 主な機能

ツール

データベースツール

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

1. process_data：データを処理します。
2. execute_query：クエリを実行します。
3. clear_table：テーブルをクリアします。

取得ツール

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

1. get_ramp_categories：Rampのカテゴリを取得します。
2. get_currencies：通貨を取得します。

ロードツール

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

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

📄 ライセンス

著作権 © 2025, Ramp商業会社 全ての権利を保有します。 このソースコードはMITライセンスの下で公開されており、ライセンスの内容はこのソースコードのルートディレクトリにあるLICENSEファイルに記載されています。