Wisp MCP

Wisp MCP — WISP ゲームパネルを AI に接続

English · Français

Wisp MCP は、WISP ゲームパネル Client API 用のソース公開型 Model Context Protocol サーバーです。MCP 対応の AI クライアントが、ホストマシンへの無制限なアクセスを AI に与えることなく、パネルを通じてゲームサーバーを調査・管理できるようにします。

ホスティングプロバイダーに依存しません。ホスティング会社から WISP パネルと Client API トークンが提供されている場合は、そのパネルの URL を使用してください。プロバイダー固有のコードパスは必要ありません。

ビジュアルガイドから始めましょう： https://wisp.hinoake.com/en/

WISP パネルを使用していますか？

ゲームサーバーパネルが次のような場合、WISP の可能性があります：

一般的な WISP クライアントダッシュボードです。ホストは WISP のホワイトラベル化が可能なため、色、ロゴ、ドメインは異なる場合があります。

確信が持てない場合は、ホストに 「私のサーバーは WISP を使用していますか？WISP Client API トークンを作成できますか？」 と問い合わせてください。WISP の見分け方も参照してください。

できること

• サーバーの状態、CPU、メモリ、ディスク、ネットワーク使用状況を確認する；
• ページ分割されたディレクトリを閲覧し、設定ファイルを読み取り、ログの末尾を取得する；
• 大きなファイルを検索し、モデルのコンテキストをあふれさせずに上限付きのチャンクを読み取る；
• ファイルを作成する、または SHA-256 による変更検出を使って既存のプラグイン／設定ファイルを安全に編集する；
• コンソールコマンドを送信する；
• サーバーを起動、停止、再起動する；
• バックアップを作成し、内容を確認する；
• 有効になっている場合はデータベースを管理する；
• 監査ログや一般的なパネルの状態を確認する；
• stdio でローカル実行するか、Streamable HTTP でリモート実行する；
• 破壊的な操作を別個の機能スイッチで制限する。

特定のゲームではなく WISP を対象としているため、同じ MCP を Rust、Minecraft、その他 WISP で管理されているゲームサーバーで使用できます。

Linux VPS にインストールする

Debian 12 または Ubuntu 24.04 以降の場合：

curl -fsSL https://raw.githubusercontent.com/BreezeDelegate/wisp-mcp/main/install-vps.sh | sudo bash

インストーラーでは、次の情報を入力します：

1. ホストから提供された WISP パネルの URL；
2. 任意のデフォルトサーバー ID；
3. 非表示のターミナルプロンプトで入力する WISP Client API トークン。

専用のシステムユーザーを作成し、認証情報を Git リポジトリの外部に保存したうえで、成功を報告する前に wisp-mcp doctor を実行します。

より詳細な読み取り専用 API 互換性チェックを行うには、wisp-mcp compatibility を実行してください。ゲームサーバーを変更せずに、MCP が使用する最小限のレスポンス契約を検証します。

ChatGPT の場合は、OpenAI トンネルヘルパーも同時にインストールしてください：

curl -fsSL https://raw.githubusercontent.com/BreezeDelegate/wisp-mcp/main/install-vps.sh | sudo bash -s -- --with-openai

AI クライアントを接続する

Wisp MCP は特定のモデルベンダーに限定されません。標準の MCP トランスポートを実装しています。

ChatGPT

常時稼働するプライベート VPS では OpenAI Secure MCP Tunnel を使用し、ChatGPT Developer Mode で MCP をカスタムアプリとして追加してください。ChatGPT のセットアップを参照してください。

Claude Code

Claude Code から Wisp MCP を直接起動できます。Wisp MCP がリモート VPS 上にある場合は、stdio コマンドとして SSH を使用してください：

claude mcp add --scope user wisp -- ssh user@your-vps /usr/local/bin/wisp-mcp-stdio

続いて、次のコマンドで確認します：

claude mcp get wisp

その他の MCP クライアント

次の標準トランスポートのいずれかを使用してください：

• stdio：/usr/local/bin/wisp-mcp-stdio、またはリモートで起動する SSH コマンド；
• Streamable HTTP：認証と安全なネットワーク境界の背後で wisp-mcp serve を実行；
• MCP Bundle：クライアントがバンドルに対応している場合は、最新リリースから .mcpb アーティファクトをダウンロード。

AI クライアントの互換性を参照してください。

ローカルでのクイックスタート

要件：Python 3.11 以降と WISP Client API トークン。

git clone https://github.com/BreezeDelegate/wisp-mcp.git
cd wisp-mcp
./setup.sh

または、既存の Python 環境内で：

python -m pip install .
wisp-mcp init
wisp-mcp doctor
wisp-mcp

設定

必須の値：

WISP_PANEL_URL=https://panel.example.com
WISP_API_TOKEN=your_token

省略可能なデフォルトサーバー：

WISP_SERVER_ID=ABCDEFGH

書き込み機能はオプトイン方式です：

WISP_ALLOW_COMMANDS=true
WISP_ALLOW_FILE_WRITES=true
WISP_ALLOW_POWER=true
WISP_ALLOW_BACKUPS=true
WISP_ALLOW_DATABASES=false
WISP_ALLOW_SERVER_SETTINGS=false
WISP_ALLOW_DESTRUCTIVE=false

通常の管理時は、WISP_ALLOW_DESTRUCTIVE=false を維持してください。ファイルの削除、バックアップの復元／削除、データベースの削除／パスワードのローテーション、強制終了、パネルの更新操作には、別途、破壊的操作の許可設定が必要です。

AI ガイド付きセットアップ

初心者の方は、次の内容を MCP 対応アシスタントにコピーしてください：

Help me install Wisp MCP from https://github.com/BreezeDelegate/wisp-mcp. Read the current repository documentation first and reply in my language. First help me confirm that my game host uses the WISP panel. Then guide me one step at a time and do as much of the technical work as possible. Never ask me to paste API tokens, passwords, private keys, or tunnel runtime keys into chat; tell me exactly where to enter secrets directly in the terminal or provider UI. Use the smallest sensible Linux VPS if I need an always-on machine. Verify the WISP connection with wisp-mcp doctor before connecting my AI client. Start read-only, enable only the capabilities I need, keep destructive operations disabled by default, back up before risky changes, and verify status and logs after every change.

AI ガイド付きセットアップとVPS のサイジングを参照してください。

配布と検索

Wisp MCP は、io.github.BreezeDelegate/wisp-mcp として公式 MCP Registryに公開されています。

リリースには次のものが含まれます：

• Python wheel；
• ソースアーカイブ；
• .mcpb MCP Bundle。

Registry への公開は、OIDC を使用した署名済み GitHub リリースワークフローによって自動化されています。

大きなファイルと安全な編集

大きなソースファイルやログを扱う場合は、関連するコードを見つけるために範囲を限定したツールから使い始めてください。ただし、正確性に必要なコンテキストを犠牲にして最適化しないでください。変更がグローバル状態、離れた場所にあるフック、共有クラス、制御フロー、またはファイル全体にわたる相互作用に依存する場合は、トークンを多く消費してもファイル全体を読んでください。

• find_in_file は、文字列の一致箇所の前後から、行番号付きの小さな抜粋を返します；
• read_file_chunk は、指定した文字数範囲と next_offset_chars を返します；
• file_fingerprint は、内容を返さずに SHA-256、バイト数、文字数、行数を返します。

通常の read_file の応答にも SHA-256 フィンガープリントが含まれます。既存ファイルでは、そのフィンガープリントを次の用途に使用してください：

• ファイル全体を意図的に置き換える場合は safe_write_file；
• 大きなファイル内の小さな範囲を正確に置き換える場合は replace_in_file。

どちらの書き込みガード付きツールも、書き込み前にファイルを再読み込みし、保存後に内容を検証します。この連携を通じて WISP Client API が比較交換方式の書き込みプリミティブを公開していないため、これは楽観的同時実行制御であり、アトミックなファイルシステムロックではありません。

サーバー、ディレクトリ、バックアップ、データベース、監査ログの一覧取得は、範囲を指定したページネーションに対応しているため、クライアントは一度に無制限の件数を読み込む必要がありません。

セキュリティモデル

API トークンと MCP トークンがツールから返されることはありません。認証が設定されていない場合、リモート HTTP 接続はデフォルトで拒否されます。ファイルパスとオブジェクト ID は検証され、書き込みには上限があり、機能の変更はオプトイン方式です。

また、サーバーは MCP クライアントに運用手順を公開します。まず調査し、リスクのある変更の前にバックアップを取り、変更を最小限に抑え、その後、ステータスとログを確認してください。

セキュリティ上の問題は、SECURITY.md に記載されている方法で非公開に報告してください。

ドキュメント

• 初心者向けビジュアルガイド
• はじめに
• WISP パネルの見分け方
• ChatGPT、Claude Code、その他の MCP クライアントの接続
• ChatGPT / OpenAI Secure MCP Tunnel
• VPS のサイジング
• 運用とセキュリティ
• AI ガイド付きセットアップ

FAQ

ホスティング会社に依存しますか？

いいえ。この連携は標準の WISP Client API を対象としています。WISP パネルを運用しているホストから提供されたパネル URL と Client API トークンを使用してください。

Rust や Minecraft に特化していますか？

いいえ。WISP が公開するゲームサーバー環境を管理するため、同じ連携をさまざまなゲームで使用できます。

すべての AI アプリで動作しますか？

いいえ。AI アプリは Model Context Protocol に対応している必要があります。Wisp MCP は標準の stdio および Streamable HTTP のデプロイパターンに対応しているため、ベンダー固有のサーバーコードなしで、一般的な MCP クライアントと互換性があります。

サーバーを変更できますか？

該当する機能が有効になっている場合に限り、変更できます。デフォルトは読み取り専用で、破壊的操作には別のスイッチが必要です。

ライセンス

Wisp MCP はPolyForm Noncommercial License 1.0.0に基づいて配布されています。商用利用のライセンスには、著作権者からの個別の許可が必要です。