Genesis MCP

🚀 創世記 MCP サーバー

このサーバーは、創世記世界のシミュレーション用のモデルコンテキストプロトコル（MCP）サーバーで、可視化機能をサポートしています。

🚀 クイックスタート

可視化機能をすぐに使い始めるには：

# 必要なコンポーネントのみをインストールする簡略化されたセットアップスクリプトを実行する
./setup.sh

# stdio クライアントを実行する（可視化ウィンドウを開く）
./examples/stdio_client.py

これにより、創世記世界のシミュレーションが直接起動し、stdio を介した可視化が開始されます。

📦 インストール

前提条件

• Python 3.8+
• uv パッケージマネージャー (pip install uv)
• npm（MCP 絶縁検出用、オプション）

インストール手順

Linux/macOS

# リポジトリをクローンする
git clone https://github.com/username/genesis-mcp.git
cd genesis-mcp

# セットアップスクリプトを実行する
./setup.sh

# 仮想環境をアクティブ化する
source .venv/bin/activate

Windows

# リポジトリをクローンする
git clone https://github.com/username/genesis-mcp.git
cd genesis-mcp

# セットアップスクリプトを実行する
setup.bat

# 仮想環境をアクティブ化する
.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 絶縁検出をインストールする（オプション）：

   npm install -g @modelcontextprotocol/inspector@0.6.0
   

💻 使用例

基本的な使用法

可視化機能をすぐに使い始めるには：

# 必要なコンポーネントのみをインストールする簡略化されたセットアップスクリプトを実行する
./setup.sh

# stdio クライアントを実行する（可視化ウィンドウを開く）
./examples/stdio_client.py

高度な使用法

サーバーの実行

# stdio 転送を使用して実行する（可視化機能に必要）
./start.sh

MCP 絶縁検出を使用したデバッグ

MCP 絶縁検出と一緒に使用するには：

# 1つのターミナルで絶縁検出を起動する
mcp-inspector

# 別のターミナルでサーバーを起動し、stdio 転送を使用する
python server.py

絶縁検出を以下のように設定します：

• 転送タイプ：STDIO
• コマンド：python
• パラメータ：server.py

📚 ドキュメント

転送方法：stdio

このサーバーは stdio 転送 を使用しており、これは創世記世界の可視化機能に必要です。 可視化コンポーネントはローカル実行環境が必要であり、ネットワーク転送では動作しません。

利用可能な情報リソース

世界情報

創世記世界の機能に関する情報を取得するには：

world_info://{name}

利用可能なツール

シミュレーションの実行

提供されたコードとパラメータを使用して創世記世界のシミュレーションを実行するには：

run_simulation

MCP クライアント

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

# Genesis World 可視化を使用してシミュレーションを実行する
./examples/stdio_client.py

ご利用いただき、ありがとうございます！