Weapon Recoil Generator – build your own recoil MCP について
Weapon Recoil Generator は、FPS ゲーム開発者向けに武器の反動パターンを生成・可視化する MCP サーバーです。HTTP エンドポイントから、武器別の軌跡データと 2D 散布図を利用できます。
主な機能
- 01マシンガンの反動軌跡生成
- 02ピストルの反動軌跡生成
- 03ショットガンの反動軌跡生成
- 04反動座標の 2D 散布図表示
- 05ローカルまたはクラウドへのデプロイ
活用シーン
- 01FPS のプロトタイプ用反動データ生成
- 02武器種ごとの反動軌跡の比較
- 03ゲームバランス調整中の軌跡確認
MCP 対応
この MCP サーバーは、HTTP エンドポイントを通じて武器の反動生成とパターン可視化のツールを MCP クライアントに提供します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
このサーバーのパッケージやリモートエンドポイントはまだ取得できていません。プロジェクトの README の手順に従ってください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Weapon Recoil Generator – 独自の反動 MCP を構築
- FPS ゲーム開発者が、シンプルな API 呼び出しで武器の反動パターンを生成・可視化できる、多用途の MCP サーバーをリリースしました。
- FPS ゲーム開発者が簡単な API 呼び出しだけで武器の反動パターンを生成し、可視化できる強力な MCP サーバーをリリースしました。
詳細を確認して Smithery にデプロイ:
WRG MCP Server
- この MCP サーバーは、「武器反動生成」と「反動の可視化」という 2 つの主要なツールを HTTP エンドポイントとして提供します。ローカルまたはクラウドにデプロイするだけで、ゲームの反動挙動をリアルタイムで調整できます。
- この MCP サーバーは「武器反動生成」と「反動の可視化」という 2 つの主要なツールを HTTP エンドポイントとして提供します。ローカルまたはクラウドにデプロイした後、リアルタイムで反動の調整を始められます。
インストール
git clone https://github.com/Hyeongseob91/mcp-server.git
cd mcp-server
pip install -r requirements.txt
開発
自動リロードを有効にして、サーバーをローカルで実行します: 自動リロード機能を有効にして、サーバーをローカルで実行します:
uvicorn main:app --reload --host 0.0.0.0 --port 8000
使用方法
Claude Desktop で設定する
Claude の設定に次の内容を追加します: Claude の設定ファイルに次の内容を追加してください:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"wrg": {
"command": "python /path/to/mcp-server/main.py --http"
}
}
}
Claude Desktop を再起動すると、/wrg および /rvz エンドポイントを直接呼び出せます。
Claude Desktop を再起動すると、/wrg および /rvz エンドポイントを直接呼び出せます。
主な機能
-
武器反動生成(WRG)
-
machinegun_recoil_points(shots: int)- 発射回数に基づいて、機関銃の反動軌跡データを生成します。
- 機関銃の発射回数に応じた反動軌跡データを生成します。
-
-
武器反動生成(WRG)
-
pistol_recoil_points(shots: int)- 発射回数に基づいて、ピストルの反動軌跡データを生成します。
- ピストルの発射回数に応じた反動軌跡データを生成します。
-
-
武器反動生成(WRG)
-
shotgun_recoil_points(shots: int)- 発射回数に基づいて、ショットガンの反動軌跡データを生成します。
- ショットガンの発射回数に応じた反動軌跡データを生成します。
-
-
反動ビジュアライザー(RVZ)
-
plot_recoil_pattern(data: Tuple[List[float], List[float]])- 入力された反動の座標データを 2D 散布図として可視化します。
- 入力された反動の座標データを 2D 散布図として可視化します。
-
-
MCP エンドポイント
/wrg/*– HTTP 経由で反動データを簡単に生成できます。/rvz/*– HTTP 経由ですぐに反動パターンを可視化できます。
-
リモートおよびローカルへのデプロイ
- FastMCP を使用して、ローカルマシンとクラウド環境(例:Smithery)の両方に同じ API をデプロイできます。
- FastMCP を使用して、ローカルおよびクラウド(例:Smithery)環境に同じ API をデプロイします。
-
API キー認証(予定)
- 外部アクセスを制御する API キーのサポートを近日中に追加する予定です。
- 外部アクセスを制御する API Key 認証機能を近日中にサポートする予定です。
期待されるメリット
-
生産性の向上
- 複雑な反動アルゴリズムを自分で実装する必要がありません。
- 複雑な反動アルゴリズムを直接実装する必要はありません。
- 組み込みの可視化ツールにより、データ検証とプロトタイピングを迅速化できます。
- 組み込みの可視化ツールにより、データ検証とプロトタイプ作成の速度が向上します。
-
コラボレーションと再利用性の向上
/wrgおよび/rvzの統一されたインターフェースにより、チームメンバー間でモジュールを簡単に共有・再利用できます。- 統合された /wrg および /rvz インターフェースにより、チーム間でモジュールを簡単に共有、再利用できます。
- バックエンド、フロントエンド、AI エンジニア、ゲーム開発者間でシームレスに連携できます。
- バックエンド、フロントエンド、AI エンジニア、ゲーム開発者間でスムーズに連携します。
-
柔軟なデプロイとスケーリング
- ローカルでテストした後、クラウドにデプロイして必要に応じてスケールできます。
- ローカルでテストした後、クラウドにデプロイして必要に応じて簡単に拡張できます。
- CI/CD パイプラインと連携し、デプロイとバージョン管理を自動化できます。
- CI/CD パイプラインと連携して、自動デプロイとバージョン管理を行えます。
-
リアルタイムのフィードバックと調整
- ゲームバランスの調整中に API を呼び出して、反動パターンをすぐに確認できます。
- ゲームバランスの調整中に API を呼び出すことで、反動パターンをすぐに確認できます。
- データに基づく意思決定により、プレイテストの効率が向上します。
- データに基づく意思決定により、プレイテストの効率が向上します。
デバッグ
- このサーバーは HTTP 経由で通信するため、詳細なログ記録と組み込みのリロードフラグを使用してください。より詳しく調査するには、Uvicorn プロセスにデバッガーを接続するか、コンソールのエラー出力を確認してください。
- このサーバーは HTTP 経由で通信するため、詳細なログ記録と --reload フラグを使用してください。より詳しく調査するには、Uvicorn プロセスにデバッガーを接続するか、コンソールのエラー出力を確認してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。