FiveM MCP — MCP-сервер для Claude Code: установка
MCP-сервер даёт ИИ-агенту доступ к FXServer и запущенному FiveM-клиенту: команды, логи и live-проверки игрового сервера.
claude mcp add --env FIVEM_HOST=<FIVEM_HOST> --env FIVEM_CLIENT_DEVCON_PORT=<FIVEM_CLIENT_DEVCON_PORT> --env FIVEM_RCON_ADDRESS=<FIVEM_RCON_ADDRESS> --env FIVEM_RCON_PASSWORD=<FIVEM_RCON_PASSWORD> --env FIVEM_SERVER_LOG=<FIVEM_SERVER_LOG> --transport stdio fivem-mcp -- npx -y fivem-mcp-serverЧто делает FiveM MCP
FiveM MCP связывает ИИ-агента с FXServer через UDP RCON и с Legacy-клиентом FiveM через devcon. Агент может получить сведения о сервере, выполнить консольную команду, читать вывод, ждать строку по регулярному выражению и запустить клиент с нужным адресом.
Серверу нужны Node 22+, работающий FXServer с заданным rcon_password и значение FIVEM_RCON_PASSWORD. FIVEM_SERVER_LOG включает чтение серверного лога, а FIVEM_MCPB_TOKEN используется мостом mcpb. Инструменты клавиатуры, мыши и скриншотов работают только на Windows. Без Legacy-клиента инструменты клиентской консоли не заработают: в Enhanced убраны devcon-порты.
Какие задачи решает
- проверить запуск ресурса в реальной игре
- выполнить команды FXServer через RCON
- прочитать консоль клиента FiveM
- дождаться нужной строки в логе
- запустить и закрыть FiveM из агента
Примеры запросов агенту
- Проверь соединения с сервером и клиентом через
status, затем сообщи, что доступно. - Запусти FiveM на
host:port, выполни проверочную команду и дождись строки с ошибкой черезwait_for_console. - Выполни консольную команду FXServer через
server_commandи покажи её вывод.
Как установить FiveM MCP
Командой платформы
claude mcp add --env FIVEM_HOST=<FIVEM_HOST> --env FIVEM_CLIENT_DEVCON_PORT=<FIVEM_CLIENT_DEVCON_PORT> --env FIVEM_RCON_ADDRESS=<FIVEM_RCON_ADDRESS> --env FIVEM_RCON_PASSWORD=<FIVEM_RCON_PASSWORD> --env FIVEM_SERVER_LOG=<FIVEM_SERVER_LOG> --transport stdio fivem-mcp -- npx -y fivem-mcp-serverВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Командой платформы
codex mcp add fivem-mcp --env FIVEM_HOST=<FIVEM_HOST> --env FIVEM_CLIENT_DEVCON_PORT=<FIVEM_CLIENT_DEVCON_PORT> --env FIVEM_RCON_ADDRESS=<FIVEM_RCON_ADDRESS> --env FIVEM_RCON_PASSWORD=<FIVEM_RCON_PASSWORD> --env FIVEM_SERVER_LOG=<FIVEM_SERVER_LOG> -- npx -y fivem-mcp-serverВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"fivem-mcp": {
"command": "npx",
"args": [
"-y",
"fivem-mcp-server"
],
"env": {
"FIVEM_HOST": "<FIVEM_HOST>",
"FIVEM_CLIENT_DEVCON_PORT": "<FIVEM_CLIENT_DEVCON_PORT>",
"FIVEM_RCON_ADDRESS": "<FIVEM_RCON_ADDRESS>",
"FIVEM_RCON_PASSWORD": "<FIVEM_RCON_PASSWORD>",
"FIVEM_SERVER_LOG": "<FIVEM_SERVER_LOG>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"fivem-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"fivem-mcp-server"
],
"env": {
"FIVEM_HOST": "<FIVEM_HOST>",
"FIVEM_CLIENT_DEVCON_PORT": "<FIVEM_CLIENT_DEVCON_PORT>",
"FIVEM_RCON_ADDRESS": "<FIVEM_RCON_ADDRESS>",
"FIVEM_RCON_PASSWORD": "<FIVEM_RCON_PASSWORD>",
"FIVEM_SERVER_LOG": "<FIVEM_SERVER_LOG>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e FIVEM_HOST=<FIVEM_HOST> -e FIVEM_CLIENT_DEVCON_PORT=<FIVEM_CLIENT_DEVCON_PORT> -e FIVEM_RCON_ADDRESS=<FIVEM_RCON_ADDRESS> -e FIVEM_RCON_PASSWORD=<FIVEM_RCON_PASSWORD> -e FIVEM_SERVER_LOG=<FIVEM_SERVER_LOG> fivem-mcp npx -y fivem-mcp-serverВместо <…> подставьте свои значения. Ещё 6 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о FiveM MCP
Как установить FiveM MCP в Claude Code?
Выполните claude mcp add fivem-mcp -e FIVEM_RCON_PASSWORD=<FIVEM_RCON_PASSWORD> -e FIVEM_MCPB_TOKEN=<FIVEM_MCPB_TOKEN> -- npx -y fivem-mcp-server.
Что делает FiveM MCP?
Он подключает агента к FXServer и Legacy-клиенту FiveM. Агент получает команды RCON и devcon, чтение консолей, запуск игры и ожидание нужного вывода.
Что нужно для работы клиентских инструментов FiveM MCP?
Нужен запущенный Legacy-клиент FiveM на той же машине, где работает сервер MCP. Для server_command требуется пароль, совпадающий с rcon_password.
