redm-mcp

redm-mcp — RedM / RDR3 文档 MCP 服务

适用于 RedM / RDR3 的模型上下文协议（MCP）服务：原生函数查询（哈希 ↔ 名称）、语义搜索、框架文档（VORP、RSGCore、oxmysql），以及 rdr3_discoveries 社区数据（行人、武器、动画、AI 标志、道具、音频库）。为 AI 编码 Agent（Claude Code、Cursor、Claude Desktop、VS Code Copilot、Zed，等等）提供准确答案，而不是猜测。

作为托管的 HTTP 传输 MCP 运行，地址为 https://redm-mcp.fivem.no/mcp——无需本地安装、无需身份验证，只需将客户端指向该地址。

此代码库仅包含安装和使用文档，并用作问题跟踪器。服务源代码为专有代码，不予分发。托管端点可免费使用。

为什么要用

Agent 读取 RedM 代码时，通常会遇到：

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

如果没有查询工具，Agent 就会猜测参数和语义。使用此服务后：

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. 在客户端中：让 Agent 查询 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 标志、枚举