适用于 FiveM 和 RedM 的 Lavender MCP 服务器

Lavender MCP Server is a development resource for FiveM, FiveM for GTAV Enhanced and RedM. It runs a small MCP (Model Context Protocol) server inside your local FXServer or Cfx Server instance so an AI coding agent like Claude Code, Codex or Cursor can interact with it.

The agent can list and restart resources, read the server console, run console commands and run JavaScript or Lua on the server or on a connected client.

Your other resources can also register their own tools through exports. If your framework has stuff you’d want the agent to be able to do (look up a player, edit some data etc) you can add it from your own resource without touching this resource via resource exports.

How can you use it?

This resource is made to speed things up when working with agents. It allows it to retrieve direct context from your running dev server and local game client(s) to perform live research, development and debugging, making it easier to accomplish work in full autonomy.

Some examples:

• “restart my_resource and check the console for errors”
• “where is my player right now” (it runs GetEntityCoords(PlayerPedId()) on your client)
• “spawn an adder next to me”
• “run status and tell me who’s connected”
• “X is broken, find out why and fix it”, then it reads the logs, edits the file, restarts the resource and checks the logs again

Security

This is for local development only, do NOT run it on a live server.

The resource only listens on 127.0.0.1, checks the Host and Origin headers, and won’t open the port if the token is shorter than 32 characters or is one of the placeholders from the example config as additional safeguards.

Tools

It won’t start, stop or restart itself.

For registering your own tools see EXTENDING.md. Each resource that registers tools needs its own ACE line in server.cfg.

Installation

Download the zip from the releases page, put the lavender-mcp-server folder in your resources, generate a random token and add this to your server.cfg:

# Token configuration
set lavender_mcp_token "PASTE_YOUR_TOKEN_HERE"

# Needed for the restart and refresh tools.
add_ace resource.lavender-mcp-server command.restart allow
add_ace resource.lavender-mcp-server command.refresh allow

ensure lavender-mcp-server

Default port is 3414, you can change it with set lavender_mcp_port 1234. When it starts it prints the URL in the console.

Then add it to your MCP client with the URL http://127.0.0.1:3414/mcp and an Authorization: Bearer <token> header.

For Claude Code:

export LAVENDER_MCP_TOKEN="<same token as in server.cfg>"

claude mcp add --transport http --scope user \
  --header "Authorization: Bearer $LAVENDER_MCP_TOKEN" \
  lavender_mcp http://127.0.0.1:3414/mcp

The README has the Codex and .mcp.json versions. Other clients should work too as long as they support Streamable HTTP.

Requirements

• FXServer artifact 25943 or newer (it needs node 22), or Cfx Server
• An MCP client that supports Streamable HTTP

Known limitations

• It can’t read client logs because the server has no access to them. Instead it tells the agent where FiveM and RedM keep their log files on your PC, which only helps if the agent runs on the same machine as the game.
• Code runs inside the resource own runtime, so it can’t see another resource’s local variables. Use that resource’s exports or register a tool for it.
• Lua code runs synchronously (you can still create threads inside it).

Links

• GitHub: GitHub – nimoalr/lavender-mcp-server: A MCP Server for FiveM and RedM development · GitHub
• Download: Release v0.2.11 · nimoalr/lavender-mcp-server · GitHub

Code is available under a MIT License.

If you find a bug please open an issue on GitHub. Contributions are welcomed.