redm-mcp

redm-mcp — RedM / RDR3 ドキュメント MCP サーバー

RedM / RDR3 向けの Model Context Protocol（MCP）サーバーです。ネイティブの検索（ハッシュ ↔ 名前）、セマンティック検索、フレームワークのドキュメント（VORP、RSGCore、oxmysql）、およびコミュニティデータ rdr3_discoveries（ped、武器、アニメーション、AI フラグ、プロップ、オーディオバンク）を提供します。AI コーディングエージェント（Claude Code、Cursor、Claude Desktop、VS Code Copilot、Zed、…）に推測ではなく正確な回答を提供します。

ホスト型の HTTP トランスポート MCP として https://redm-mcp.fivem.no/mcp で動作します。ローカルへのインストールも認証も不要で、クライアントの接続先に指定するだけです。

このリポジトリにはインストール／使用方法のドキュメントのみが含まれており、課題トラッカーとして機能します。サーバーのソースコードはプロプライエタリで、配布されていません。ホストされたエンドポイントは無料で使用できます。

理由

エージェントが RedM のコードを読み取る際、通常は次のようなものに遭遇します。

Citizen.InvokeNative(0x09C28F828EE674FA, player, 1.5, 5000)

検索せずに使うと、エージェントはパラメーターやセマンティクスを推測します。このサーバーを使えば、次のようになります。

lookup_native({ hash: "0x09C28F828EE674FA" })
→ BOOST_PLAYER_HORSE_SPEED_FOR_TIME(player Player, speedBoost float, duration int)

このサーバーは MCP の instructions を通じて使い方を通知するため、スキルやクライアントの追加設定は必要ありません。

ツール

ツール	用途
lookup_native	ハッシュまたは名前で正確に検索します。O(1)。Citizen.InvokeNative(0x...) または SCREAMING_SNAKE_CASE の名前に使用します。
semantic_search	動作や概念（「プレイヤーをテレポート」「馬をスポーン」など）で検索します。
grep_docs	ドキュメントの生ファイル全体を正規表現／リテラルで検索します。埋め込みではプレビューのみインデックス化される、大規模な rdr3_discoveries データテーブル（audio_banks、ingameanims、…）の検索に必要です。
list_namespaces	カテゴリと名前空間を一覧表示します。
browse	カテゴリ／名前空間内のドキュメントパスを一覧表示します。
get_document	ドキュメントパスに対応する Markdown 全文を取得します。

クライアントの設定

すべてのクライアントは https://redm-mcp.fivem.no/mcp に接続します。認証は不要です。

VS Code および Cursor のユーザー：上のインストールバッジをクリックすると、ワンクリックで設定できます。それ以外の場合は、以下の設定をコピーして貼り付けてください。 examples/ にすぐに使えるファイルもあります。

Claude Code

claude mcp add --transport http redm-mcp https://redm-mcp.fivem.no/mcp

または ~/.claude.json を手動で編集します。

{
  "mcpServers": {
    "redm-mcp": {
      "type": "http",
      "url": "https://redm-mcp.fivem.no/mcp"
    }
  }
}

Cursor

~/.cursor/mcp.json（またはプロジェクトルートの .cursor/mcp.json）を編集します。

{
  "mcpServers": {
    "redm-mcp": {
      "url": "https://redm-mcp.fivem.no/mcp"
    }
  }
}

Cursor を再起動します。Settings → MCP でステータスが緑色になっていることを確認します。

Claude Desktop

Claude Desktop は HTTP MCP を直接サポートしていないため、プロキシとして mcp-remote を使用します。~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "redm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://redm-mcp.fivem.no/mcp"
      ]
    }
  }
}

Claude Desktop を再起動します。

VS Code（Copilot / Continue）

プロジェクトルートにある .vscode/mcp.json：

{
  "servers": {
    "redm-mcp": {
      "type": "http",
      "url": "https://redm-mcp.fivem.no/mcp"
    }
  }
}

Zed

~/.config/zed/settings.json：

{
  "context_servers": {
    "redm-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://redm-mcp.fivem.no/mcp"
        ]
      }
    }
  }
}

その他のクライアント（汎用）

• HTTP トランスポートのクライアント：https://redm-mcp.fivem.no/mcp を接続先に指定します
• stdio のみ対応するクライアント：プロキシとして mcp-remote を使用します

動作確認

1. curl https://redm-mcp.fivem.no/health → {"ok":true}
2. curl https://redm-mcp.fivem.no/ingest-status → バージョンと最後に取り込まれたタイムスタンプが表示されます
3. クライアントで、エージェントに 0x09C28F828EE674FA を検索するよう依頼します。BOOST_PLAYER_HORSE_SPEED_FOR_TIME が返されるはずです

エンドポイント

パス	認証	目的
POST /mcp	不要	MCP プロトコル
GET /health	不要	稼働状態
GET /ingest-status	不要	{ current, last, ingestedAt, upToDate }
GET /stats	不要	使用状況の統計（ツールのカウンター、実行時間、内訳）。メタデータのみで、クエリやシークレットは保存されません。
GET /dashboard	不要	/stats の HTML ダッシュボード。

プロンプトの例

インストール後に試せる内容（ネイティブ検索、動作の検索、フレームワーク／インベントリに関する質問、デバッグ）については、examples/prompts.md を参照してください。

問題／フィードバック

バグ、ドキュメントの不足、ネイティブ検索の誤り、新しいツールのリクエストなどがあれば、イシューを作成してください。

ドキュメントのソース

インデックス対象の上流リポジトリ：

• femga/rdr3_discoveries — コミュニティによる ped／weapon／anim／prop のハッシュ、AI フラグ、列挙型