Skip to main content
Glama
deenesjakoruzh
marhenrik635-oss

MCP on My SAMP

by marhenrik635-oss
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

MCP on My SAMP

スコープ: ローカルサーバー、または自分が所有・許可したサーバーのみを対象とします。公開サーバーを自動化するためのツールではありません。

できること

MCP on My SAMP を使用すると、AI エージェントが再現可能なワークフローでゲームサーバーをテストできます:

  • open.mp の起動 / 停止 / ステータス確認;

  • ヘッドレス RakClient の起動 / 停止 / ステータス確認;

  • クライアントが実際に Spawned になるのを待機;

  • 許可されたスラッシュコマンドの送信;

  • クライアントの出力履歴の読み取り;

  • サーバーのレスポンスがクライアントに届いたことを検証;

  • Pawn のゲームモードソースからコマンドを発見;

  • 許可リスト外のコマンドを拒否。

フラッド、スパム、ラグ注入、任意の RCON、公開サーバー向けの自動化は提供しません。

ワークフロー

flowchart LR
    A[AI Agent] -->|MCP stdio| B[MCP on My SAMP]
    B --> C[open.mp Server]
    B --> D[Headless RakClient]
    D -->|UDP localhost| C
    C -->|server response| D
    D --> B
    B -->|assertion| A

有効なラウンドトリップの証明:

command dikirim
→ server callback menerima command
→ gamemode mengirim response
→ client menerima response
→ MCP assertion berhasil

Spawned だけではコマンド成功の証明にはなりません。

インストール

1. Python の準備

Python 3.10 以降 が必要です。

2. プロジェクトのインストール

リポジトリのルートから実行してください:

Windows

py -3 -m venv .venv
.venv\Scripts\activate
python -m pip install --upgrade pip
python -m pip install ".[dev]"

Linux / macOS

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install ".[dev]"

3. 検証

pytest -q

期待される出力:

35 passed

open.mp と RakClient のバイナリはライブテストでのみ必要です。Python のユニットテストは、これらのバイナリがなくても実行できます。

設定

テンプレートからローカル設定ファイルを作成します:

Windows

copy config.example.json local-server.json

Linux / macOS

cp config.example.json local-server.json

ファイルの内容:

{
  "executable": "vendor/openmp/Server/omp-server.exe",
  "working_dir": "vendor/openmp/Server",
  "args": ["--config-path", "config.json"],
  "ready_text": "Legacy Network started on port",
  "startup_timeout": 30
}

executable と working_dir は、お使いのコンピューター上の open.mp の場所に合わせて変更してください。local-server.json は各コンピューターでパスが異なるため、Git には含まれません。

MCP サーバーの実行

サーバーのみ

mcp-gta-samp --config local-server.json

ヘッドレス RakClient を使用する場合

Windows

mcp-gta-samp ^
  --config local-server.json ^
  --client-executable vendor/rakclient-bin/rakclient.exe ^
  --client-arg --server ^
  --client-arg 127.0.0.1:7777 ^
  --client-arg --nick ^
  --client-arg MCPBot ^
  --client-arg --scripts-dir ^
  --client-arg vendor/rakclient-bin/scripts ^
  --gamemode-source vendor/openmp/Server/gamemodes/mcp_test.pwn

Linux / macOS

mcp-gta-samp \
  --config local-server.json \
  --client-executable vendor/rakclient-bin/rakclient \
  --client-arg --server \
  --client-arg 127.0.0.1:7777 \
  --client-arg --nick \
  --client-arg MCPBot \
  --client-arg --scripts-dir \
  --client-arg vendor/rakclient-bin/scripts \
  --gamemode-source vendor/openmp/Server/gamemodes/mcp_test.pwn

MCP のトランスポートは stdio を使用します。

MCP ツール

ツール

機能（はたらき）

server_start

サーバーを起動し、準備完了（レディネス）を待機します。

server_status

サーバーのステータスと PID を確認します。

server_stop

サーバーを停止します。

client_start

ヘッドレス RakClient を起動します。

client_status

クライアントのステータスを確認します。

client_stop

クライアントを停止します。

client_send_chat

Spawned 後に許可されたスラッシュコマンドを送信します。

client_get_history

バッファリングされたクライアントの出力を取得します。

client_assert_output

特定の出力がクライアントに届いたことを確認します。

server_list_commands

Pawn ソースからコマンドを表示します。

server_assert_command

コマンドを許可リストに対して検証します。

最後の 2 つのツールは、--gamemode-source を使用した場合に利用できます。

AI エージェント向けワークフロー

1. server_status
2. server_start jika belum berjalan
3. client_start
4. tunggu state Spawned
5. server_list_commands
6. server_assert_command("/help")
7. client_send_chat("/help")
8. client_assert_output("MCP Test Commands:")
9. client_get_history bila perlu diagnosis
10. client_stop
11. server_stop

エージェントへの重要な指示:

  • 公開サーバーにアクセスしないこと;

  • ブート、参加、Spawned をコマンドのラウンドトリップとして見なさないこと;

  • 失敗した場合は、境界を分類すること: ブート、接続、スポーン、キュー、アウトバウンドパケット、サーバーコールバック、サーバーレスポンス、クライアントパーサー、MCP アサーション;

  • テストが終了したら必ずプロセスを停止すること;

  • UDP ポート 7777 が再び空き状態になっていることを確認すること。

ライブテストの例

テスト用ゲームモードは次の場所にあります:

vendor/openmp/Server/gamemodes/mcp_test.pwn

利用可能なコマンド:

/help
/status

Pawn ソースを変更した場合は、サーバーフォルダーから .amx を再コンパイルしてください:

qawno\pawncc.exe -i.\qawno\include -o.\gamemodes\mcp_test .\gamemodes\mcp_test.pwn

ライブワークフロー:

server_start
→ client_start
→ client mencapai Spawned
→ client_send_chat("/help")
→ client_assert_output("MCP Test Commands:")
→ client_assert_output("/status - show a test response")
→ client_stop
→ server_stop

ヘッドレス RakClient はプロトコル、状態、コマンドを証明します。スクリーンショットは生成しません。視覚的な確認は、レンダリングされた GTA クライアントを別途使用する必要があります。

開発

テストを実行:

pytest -q

wheel を作成:

python -m pip wheel . --no-deps -w dist

wheel をインストール:

python -m pip install dist/mcp_gta_samp-0.1.0-py3-none-any.whl

コア構成物:

mcp_gta_samp/       package Python dan MCP facade
tests/              unit, contract, dan bridge tests
config.example.json template konfigurasi
vendor/             binary dan fixture live test

セキュリティ

この MCP の利用範囲はローカル / 所有サーバーに限定されます。認証情報、プロキシプール、プライベート設定、プライベートログ、テストサーバーのデータを公開リポジトリに含めないでください。

インターネットからサーバーを実行する場合は、認証とネットワークの分離を自分で追加してください。このパッケージは公開のゲーム制御 API として設計されていません。

ライセンス

MIT License。 LICENSEを参照してください。

リンク

This server cannot be installed

-
license - not tested
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • Remote Desktop Commander

    Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

  • microservices.sh

    MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.

  • Flato Design MCP

    Connect AI agents to Flato's editable canvas runtime through a hosted MCP server.

View all MCP Connectors

Latest Blog Posts

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/marhenrik635-oss/mcponmysamp'

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