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を使用した手動インストール

依存関係を手動でインストールする場合:

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/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

楽しいハッキングを！