Skip to main content
Glama

FiveM MCP Server

by eeharumt
GitHub
TypeScript
MIT License
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

mcp-fivem MCP Server

FiveM RCON Model Context Protocolサーバー

このTypeScriptベースのMCPサーバーは、FiveMプラグイン開発のデバッグとサーバー管理機能を提供します：

  • RCON経由でのFiveMサーバー通信
  • プラグインの管理（ensure、stop、restart）
  • サーバーログの監視とプラグインログの取得
  • FiveMクライアントログの取得
  • スクリプト経由でのF8コンソールコマンド実行（ExecuteCommand）
  • イベントシステムによるサーバー・クライアント間通信
  • FiveMプラグイン（mcp-bridge）との連携
  • リソースの更新とサーバーステータスの確認
  • 任意のRCONコマンドの実行

🚀 新しい統合ツール（v0.3.0）

改善点:

  • ✅ 17個のツールを7個に統合
  • ✅ 統一された命名規則（fivem_* プレフィックス）
  • ✅ サーバー・クライアント間でのコマンド実行機能追加
  • ✅ 直接RCONコマンド実行の分離
  • ✅ ResponseParserの改善でエラー処理を最適化
  • ✅ 機能的グループ化で直感的な操作
  • ✅ 冗長性の排除で保守性向上

📋 統合ツール一覧

1. fivem_plugin_manage - プラグイン管理

プラグインの開始、停止、再起動、リソース更新を統合管理

パラメータ:

  • action (必須): "ensure" | "stop" | "restart" | "refresh"
  • plugin_name (ensure/stop/restart時必須): プラグイン名

使用例:

# プラグインの開始 fivem_plugin_manage --action ensure --plugin_name my-plugin # プラグインの停止 fivem_plugin_manage --action stop --plugin_name my-plugin # プラグインの再起動 fivem_plugin_manage --action restart --plugin_name my-plugin # リソースの更新（fxmanifest変更後など） fivem_plugin_manage --action refresh
2. fivem_command_execute - コマンド実行

サーバーサイドとクライアントサイドでのコマンド実行を統合

パラメータ:

  • mode (必須): "server" | "client"
    • "server": サーバー側でコマンドを実行
    • "client": クライアント側でコマンドを実行
  • command (必須): 実行するコマンド
  • player_id (オプション): クライアントモード時のターゲットプレイヤーID（未指定の場合は全クライアントで実行）

使用例:

# サーバー側でコマンド実行 fivem_command_execute --mode server --command "say Hello from Server!" # 特定プレイヤーのクライアントでコマンド実行 fivem_command_execute --mode client --command "me waves hand" --player_id 1 # 全クライアントでコマンド実行 fivem_command_execute --mode client --command "engine"
3. fivem_rcon_execute - 直接RCONコマンド実行

低レベルなサーバー管理のための直接RCONコマンド実行

パラメータ:

  • command (必須): 実行するRCONコマンド

使用例:

# 直接RCONコマンド実行（サーバー管理用） fivem_rcon_execute --command "status" # リソース管理 fivem_rcon_execute --command "restart my-plugin"
4. fivem_event_trigger - イベントトリガー

サーバー・クライアント間のイベントトリガーを統合

パラメータ:

  • type (必須): "server" | "client"
  • event_name (必須): イベント名
  • player_id (client時必須): プレイヤーID
  • args (オプション): JSONエンコードされた引数

使用例:

# サーバーイベントのトリガー fivem_event_trigger --type server --event_name playerJoined --args '["player123", "NewPlayer"]' # クライアントイベントのトリガー fivem_event_trigger --type client --event_name showNotification --player_id 1 --args '["Hello Client!"]'
5. fivem_player_get - プレイヤー情報取得

プレイヤー一覧取得と詳細情報取得を統合

パラメータ:

  • action (必須): "list" | "info"
  • player_id (info時必須): プレイヤーID

使用例:

# プレイヤー一覧取得 fivem_player_get --action list # 特定プレイヤーの詳細情報取得 fivem_player_get --action info --player_id 1
6. fivem_logs_get - ログ取得

サーバー・クライアント・プラグインログ取得を統合

パラメータ:

  • source (必須): "server" | "server_plugin" | "client" | "client_plugin"
  • lines (オプション): 取得行数（デフォルト値はソースによって異なる）
  • plugin_name (オプション): プラグイン名（*_plugin時のみ）

使用例:

# サーバーログ取得 fivem_logs_get --source server --lines 100 # 特定プラグインのサーバーログ取得 fivem_logs_get --source server_plugin --plugin_name my-plugin --lines 50 # クライアントログ取得 fivem_logs_get --source client --lines 100 # 特定プラグインのクライアントログ取得 fivem_logs_get --source client_plugin --plugin_name my-plugin --lines 50
7. fivem_system_manage - システム管理

システムヘルスチェック、ログクリアを統合

パラメータ:

  • action (必須): "health" | "clear"

使用例:

# プラグインのヘルスチェック fivem_system_manage --action health # ログのクリア fivem_system_manage --action clear

FiveMプラグイン連携

MCPサーバーは専用のFiveMプラグイン（mcp-bridge）と連携することで、RCONでは実現できない高度な機能を提供します：

🔗 連携アーキテクチャ

MCP Server ←→ RCON Protocol ←→ FiveM Server ←→ mcp-bridge Plugin

新方式の特徴:

  • ✅ HTTPサーバー不要
  • ✅ 既存のRCON接続を活用
  • ✅ シンプルな実装
  • ✅ リアルタイム通信
  • ✅ 軽量で高速

🚀 プラグイン経由で利用可能な機能

  • サーバーサイドコマンド実行: RCONカスタムコマンド経由でExecuteCommandを使用
  • クライアントサイドコマンド実行: 特定プレイヤーまたは全プレイヤーでのコマンド実行
  • リアルタイムイベント: TriggerEvent/TriggerClientEventの直接実行
  • プレイヤー管理: オンラインプレイヤーの詳細情報取得
  • ヘルスチェック: プラグインの状態監視

🆕 v0.3.0の新機能

  • クライアント・サーバー分離: fivem_command_executeでサーバーとクライアント側を明確に分離
  • 直接RCON実行: fivem_rcon_executeで低レベルなサーバー管理コマンドを実行
  • エラー処理改善: ResponseParserの最適化により、プラグインからのレスポンスを正確に解析
  • 新RCONコマンド: mcp_client_command、mcp_client_command_allをプラグインに追加

🔧 FiveMプラグインのインストール

  1. fivem-plugin/mcp-bridge フォルダを FiveM サーバーの resources ディレクトリにコピー
  2. server.cfg に以下を追加:
ensure mcp-bridge
  1. FiveMサーバーを再起動

🎯 使用例

# サーバー側でメッセージ送信 fivem_command_execute --mode server --command "say Hello from MCP Bridge!" # クライアント側でコマンド実行 fivem_command_execute --mode client --command "me waves" --player_id 1 # サーバーイベントのトリガー fivem_event_trigger --type server --event_name playerJoined --args '["player123", "NewPlayer"]' # プレイヤー情報の取得 fivem_player_get --action info --player_id 1 # プラグインの健康状態チェック fivem_system_manage --action health # 直接RCONコマンド実行 fivem_rcon_execute --command "status"

機能詳細

リソース

  • fivem://logs/recent - 最新のサーバー操作ログ
  • fivem://console/info - サーバーコンソール情報（ログファイル経由）

ツール

サーバー管理
  • fivem_plugin_manage - プラグイン管理（ensure/stop/restart/refresh）
  • fivem_command_execute - コマンド実行（Server/Client）
  • fivem_rcon_execute - 直接RCONコマンド実行
  • fivem_event_trigger - イベントトリガー（Server/Client）
  • fivem_player_get - プレイヤー情報取得（List/Info）
  • fivem_logs_get - ログ取得（Server/Client/Plugin）
  • fivem_system_manage - システム管理（Health/Clear）

開発

依存関係のインストール:

npm install

サーバーのビルド:

npm run build

開発時の自動リビルド:

npm run watch

インストール

Cursor IDE

Cursor IDEで使用するには、設定を追加します：

  1. Cursor IDE設定を開く（Cmd/Ctrl + ,）
  2. "MCP"で検索
  3. 以下の設定を追加：
{ "mcp.servers": { "mcp-fivem": { "command": "/path/to/mcp-fivem/build/index.js", "env": { "RCON_ADDRESS": "localhost", "RCON_PORT": "30120", "RCON_PASSWORD": "your_rcon_password", "FIVEM_LOGS_DIR": "/path/to/your/fivem/txData/default/logs" } } } }

または、Cursor設定ファイル（settings.json）に直接追加することもできます。

環境変数設定

以下の環境変数を設定することで、自動接続やデフォルト値を利用できます：

  • RCON_ADDRESS: FiveMサーバーのホスト（必須）
  • RCON_PORT: RCONポート（必須）
  • RCON_PASSWORD: RCONパスワード（必須）
  • FIVEM_LOGS_DIR: サーバーログファイルが格納されているディレクトリのパス（サーバーログ機能使用時は必須）
  • FIVEM_CLIENT_LOGS_DIR: クライアントログファイルが格納されているディレクトリのパス（クライアントログ機能使用時は必須）

すべての環境変数が設定されている場合、MCPサーバー起動時に自動的に接続を試行します。

ログ機能について:

  • fivem_logs_get --source serverおよびfivem_logs_get --source server_pluginツールを使用するには、FIVEM_LOGS_DIRの設定が必須です。
  • fivem_logs_get --source clientおよびfivem_logs_get --source client_pluginツールを使用するには、FIVEM_CLIENT_LOGS_DIRの設定が必須です。

ログディレクトリパスの設定

サーバーログ（FIVEM_LOGS_DIR）

FIVEM_LOGS_DIRには、サーバーログファイル（fxserver.log、server.log等）が直接格納されているディレクトリを指定してください。

設定例:

export FIVEM_LOGS_DIR="/path/to/server/txData/default/logs"
クライアントログ（FIVEM_CLIENT_LOGS_DIR）

FIVEM_CLIENT_LOGS_DIRには、FiveMクライアントログファイル（CitizenFX.log等）が直接格納されているディレクトリを指定してください。

設定例:

# Windows export FIVEM_CLIENT_LOGS_DIR="C:\Users\username\AppData\Local\FiveM\FiveM.app\logs" # Linux/WSL2 export FIVEM_CLIENT_LOGS_DIR="/home/username/.local/share/CitizenFX"

完全な環境変数設定例:

export RCON_ADDRESS="localhost" export RCON_PORT="30120" export RCON_PASSWORD="your_rcon_password" export FIVEM_LOGS_DIR="/path/to/server/txData/default/logs" export FIVEM_CLIENT_LOGS_DIR="/home/username/.local/share/CitizenFX"

ディレクトリ構造例:

# サーバーログ /path/to/server/txData/default/logs/ ← FIVEM_LOGS_DIRで直接指定 ├── fxserver.log ← メインログファイル ├── server.log ← サーバーログファイル └── fxserver_20240101.log ← 日付付きバックアップ # クライアントログ /home/username/.local/share/CitizenFX/ ← FIVEM_CLIENT_LOGS_DIRで直接指定 ├── CitizenFX.log ← メインクライアントログ ├── CitizenFX_log.txt ← 追加ログファイル └── launcher.log ← ランチャーログ

🚀 移行について

旧ツールからの移行

既存のツールは後方互換性のため保持されていますが、新しい統合ツールの使用を推奨します：

旧ツール新ツール変更点
ensure_pluginfivem_plugin_manageaction: "ensure"
stop_pluginfivem_plugin_manageaction: "stop"
restart_pluginfivem_plugin_manageaction: "restart"
execute_commandfivem_rcon_execute直接RCONコマンド実行
execute_plugin_commandfivem_command_executemode: "server"
trigger_server_event_pluginfivem_event_triggertype: "server"
trigger_client_event_pluginfivem_event_triggertype: "client"
get_players_pluginfivem_player_getaction: "list"
get_player_info_pluginfivem_player_getaction: "info"
get_fivem_server_logsfivem_logs_getsource: "server"
get_fivem_server_plugin_logsfivem_logs_getsource: "server_plugin"
get_fivem_client_logsfivem_logs_getsource: "client"
get_fivem_client_plugin_logsfivem_logs_getsource: "client_plugin"

| check_plugin_health | fivem_system_manage | action: "health" | | refresh_resources | fivem_plugin_manage | action: "refresh" | | clear_logs | fivem_system_manage | action: "clear" |

npm run inspector

InspectorはブラウザでデバッグツールにアクセスするためのURLを提供します。

📝 変更履歴

v0.3.0 (2025-07-06)

  • 🆕 新機能: サーバー・クライアント間でのコマンド実行機能追加
  • 🆕 新ツール: fivem_rcon_execute - 直接RCONコマンド実行
  • 🔧 改善: fivem_command_executeをmode: "server"/"client"に変更
  • 🔧 改善: ResponseParserの最適化でエラー処理を改善
  • 🔧 改善: FiveMプラグインにmcp_client_command、mcp_client_command_allコマンド追加
  • 📖 更新: ドキュメントとREADMEの全面的な更新

v0.2.0

  • 🆕 新機能: 17個のツールを6個に統合
  • 🆕 新機能: 統一された命名規則（fivem_* プレフィックス）
  • 🔧 改善: 機能的グループ化で直感的な操作
  • 🔧 改善: 冗長性の排除で保守性向上

v0.1.0

  • 🎉 初回リリース: 基本的なFiveM RCON機能
  • 🆕 新機能: プラグイン管理、ログ取得、イベントシステム

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

A TypeScript-based server that provides debugging and management capabilities for FiveM plugin development, allowing developers to control plugins, monitor server logs, and execute RCON commands.

  1. 🚀 新しい統合ツール（v0.3.0）
    1. 📋 統合ツール一覧
  2. FiveMプラグイン連携
    1. 🔗 連携アーキテクチャ
    2. 🚀 プラグイン経由で利用可能な機能
    3. 🆕 v0.3.0の新機能
    4. 🔧 FiveMプラグインのインストール
    5. 🎯 使用例
  3. 機能詳細
    1. リソース
    2. ツール
  4. 開発
    1. インストール
      1. Cursor IDE
    2. 環境変数設定
      1. ログディレクトリパスの設定
    3. 🚀 移行について
      1. 旧ツールからの移行
    4. 📝 変更履歴
      1. v0.3.0 (2025-07-06)
      2. v0.2.0
      3. v0.1.0

    Related MCP Servers

    • language-server-mcp

      alexwohletz
      A
      security
      A
      license
      A
      quality
      TypeScript-based MCP server designed to enhance code editing experiences by providing features such as hover information, code completion, and diagnostics.
      Last updated -
      3
      13
      MIT License
      • Apple

    • github-manager MCP Server

      wheelhousedev
      A
      security
      A
      license
      A
      quality
      This TypeScript-based MCP server enables users to manage a simple notes system with capabilities to create and summarize notes through structured prompts and resources.
      Last updated -
      5
      0
      TypeScript
      MIT License
      • Apple

    • SystemPrompt MCP Server

      Ejb503
      -
      security
      F
      license
      -
      quality
      This TypeScript-based server implements a simple notes system, allowing users to create and manage text notes and generate summaries, showcasing core MCP concepts.
      Last updated -
      2
      7
      TypeScript
      • Apple

    • MCP Server

      seonglae
      -
      security
      F
      license
      -
      quality
      This TypeScript-based MCP server allows users to manage a simple notes system through creating and summarizing text notes using Model Context Protocol (MCP).
      Last updated -
      670
      6
      TypeScript
      • Apple

    View all related MCP servers

    New MCP Servers

    MCP directory API

    We provide all the information about MCP servers via our MCP API.

    curl -X GET 'https://glama.ai/api/mcp/v1/servers/eeharumt/fivem-mcp'

    If you have feedback or need assistance with the MCP directory API, please join our Discord server