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 の視覚化機能に必要な標準入出力トランスポートを使用しています。視覚化コンポーネントはローカルランタイムを必要とするため、ネットワークトランスポート経由では動作しません。

設定

前提条件

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

楽しいハッキングを！

Genesis MCP Server

Integrations