Genesis MCP Server

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 シミュレーションを直接開始します。

トランスポート方式：stdio

このサーバーは、Genesis World の可視化機能に必要な stdio トランスポート を使用します。 可視化コンポーネントにはローカルランタイムが必要なため、ネットワークトランスポートでは動作しません。

セットアップ

前提条件

• 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

Windows

# 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 による手動インストール

依存関係を手動でインストールする場合は、次の手順に従ってください。

1. 仮想環境を作成します。

   uv venv .venv
   source .venv/bin/activate  # Linux/macOS
   .venv\Scripts\activate.bat  # Windows
   

2. ロックファイルから依存関係をインストールします。

   uv pip install -r requirements.lock
   uv pip install -e .
   uv pip install genesis==0.2.1 --no-deps
   

3. MCP Inspector をインストールします（任意）。

   npm install -g @modelcontextprotocol/[email protected]
   

サーバーの実行

# 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 Inspector を次のように設定します。

• トランスポートの種類：STDIO
• コマンド：python
• 引数：server.py

利用可能なリソース

World Info

Genesis World の機能に関する情報を取得します。

world_info://{name}

利用可能なツール

シミュレーションの実行

指定したコードとパラメーターで Genesis World シミュレーションを実行します。

run_simulation

MCP クライアント

このリポジトリには、可視化用の stdio クライアントが含まれています。

# Run a simulation with Genesis World visualization
./examples/stdio_client.py

ハッピーコーディング！