제네시스 MCP 서버

시각화 지원을 포함한 Genesis World 시뮬레이션을 위한 MCP(Model Context Protocol) 서버입니다.

빠른 시작

시각화를 시작하는 가장 빠른 방법:

지엑스피1

이렇게 하면 stdio 전송을 사용하여 시각화를 통해 Genesis World 시뮬레이션이 직접 시작됩니다.

전송 방법: stdio

이 서버는 Genesis World 시각화 기능에 필요한 stdio 전송을 사용합니다. 시각화 구성 요소는 로컬 런타임이 필요하며 네트워크 전송을 통해 작동할 수 없습니다.

설정

필수 조건

파이썬 3.8 이상
uv 패키지 관리자( pip install uv )
npm(선택 사항, MCP Inspector용)

설치

리눅스/맥OS

# 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