Genesis MCP サーバー
視覚化をサポートする Genesis World シミュレーション用の Model Context Protocol (MCP) サーバー。
クイックスタート
視覚化を始めるための最も早い方法:
# Run the simplified setup script (only installs what's needed)
./setup.sh
# Run the stdio client (opens a visualization window)
./examples/stdio_client.py
これにより、stdio トランスポートを使用した視覚化を伴う Genesis World シミュレーションが直接開始されます。
Related MCP server: Hello World MCP Server
転送方法: stdio
このサーバーは、Genesis World の視覚化機能に必要な標準入出力トランスポートを使用しています。視覚化コンポーネントはローカルランタイムを必要とするため、ネットワークトランスポート経由では動作しません。
設定
前提条件
Python 3.8以上
uv パッケージ マネージャー (
pip install uv)npm (オプション、MCP Inspector 用)
インストール
Linux/macOS
# Clone the repository
git clone https://github.com/username/genesis-mcp.git
cd genesis-mcp
# Run the setup script
./setup.sh
# Activate the virtual environment
source .venv/bin/activate
ウィンドウズ
# Clone the repository
git clone https://github.com/username/genesis-mcp.git
cd genesis-mcp
# Run the setup script
setup.bat
# Activate the virtual environment
.venv\Scripts\activate.bat
UVを使用した手動インストール
依存関係を手動でインストールする場合:
仮想環境を作成します。
uv venv .venv source .venv/bin/activate # Linux/macOS .venv\Scripts\activate.bat # Windowsロック ファイルから依存関係をインストールします。
uv pip install -r requirements.lock uv pip install -e . uv pip install genesis==0.2.1 --no-depsMCP Inspector をインストールします (オプション):
npm install -g @modelcontextprotocol/inspector@0.6.0
サーバーの実行
# Run with stdio transport (required for visualization)
./start.sh
### Using with the MCP Inspector
To use with the MCP Inspector for debugging:
```bash
# In one terminal, start the inspector
mcp-inspector
# In another terminal, start the server with stdio transport
python server.py
MCP インスペクターを次のように構成します。
トランスポートタイプ: STDIO
コマンド: python
引数: server.py
利用可能なリソース
世界情報
Genesis World の機能に関する情報を入手します:
world_info://{name}
利用可能なツール
シミュレーションを実行する
提供されたコードとパラメータを使用して Genesis World シミュレーションを実行します。
run_simulation
MCPクライアント
リポジトリには視覚化用の stdio クライアントが含まれています。
# Run a simulation with Genesis World visualization
./examples/stdio_client.py
楽しいハッキングを！