Genesis-Gemini-MCP（非官方扩展）
这个项目是对（某方案/系统）的修改后实施版本 创世纪（或指创世、起源） 与……集成 Google Gemini AI（谷歌Gemini人工智能） 以模型上下文协议（MCP）风格。
- Genesis MCP（本仓库）https://github.com/nitichidasho/genesis_gemini_mcp 翻译为中文可以是：“https://github.com/nitichidasho/genesis_gemini_mcp（GitHub项目链接，用于展示Genesis与Gemini的MCP相关实现或代码）”。不过，通常在中文语境下，我们可能不会直接翻译网址，而是直接引用网址，并在必要时简要说明其内容或用途。如果仅需要翻译网址后的内容作为说明，那么“Genesis与Gemini的MCP相关实现或代码”是合适的翻译。但如果是直接翻译整个网址表达，通常保持原样即可\
获准使用/授权于 麻省理工学院许可证. 查看 许可证 文件中有详细信息。
- 创世纪（原始框架）https://github.com/Genesis-Embodied-AI/Genesis 翻译为中文可以是：“https://github.com/（GitHub网站）上的Genesis-Embodied-AI组织的Genesis项目” 或者简化为 “GitHub上的Genesis项目（由Genesis-Embodied-AI维护）”。不过，为了保持网址的原样和通用性，通常直接保留网址不变，仅对组织名称和项目名称进行翻译说明。所以，也可以直接表述为：“GitHub上的Genesis项目，隶属于Genesis-Embodied-AI组织”\
获准使用于 Apache许可证2.0。
此存储库在Genesis之上提供了一个MCP风格的接口，用于自然语言驱动的模拟。
致谢
- 这个项目是在 创世纪 （Apache 2.0 许可证）
- 由……进行的扩展和修改 千田翔太（注：Shota Chida 的中文译名可能因翻译习惯或个人偏好而有所不同，此处为一种可能的译法）
🚀 表情符号“🚀”在中文中通常被直接保留为表情符号，不直接翻译为文字，但如果要解释其含义，可以是“火箭”或“快速前进”的意思。在实际使用中，它常被用来表示速度、进步或兴奋等情感。 AI驱动的物理模拟 与Gemini AI整合的Genesis World模型上下文协议（MCP）服务器
将Genesis World与Google Gemini AI相结合，可从自然语言生成物理模拟代码。借助VNC功能，即使在SSH/远程环境中也能实现3D显示。
______________________________________________________________________
主要特点
🧠 表示“大脑”或“思考”。 双子座AI整合
- 从自然语言自动生成Genesis World代码
- 专用于物理模拟的模板系统
- 智能代码补全与优化
🖥️ 电脑 VNC优化显示
- 在SSH环境下实时显示Genesis World 3D查看器
- 低延迟的x11vnc优化设置（800x600@15fps）
- 支持Windows/Mac/Linux的VNC客户端
⚡（闪电符号，常用于表示快速、能量或惊喜等含义，在此可直译为“⚡”或根据上下文意译为相应词汇，但在此保留原符号形式以体现其通用性） 高性能架构
- 基于模型上下文协议（MCP）的标准化通信
- 通过异步处理提高响应速度
- UV高速包装管理和清洁虚拟环境
🎯（瞄准靶心） 开发者体验
- 一键式环境设置
- 集成测试和调试工具
______________________________________________________________________
快速启动
📋 前提条件
- python3.11以上
- 操作系统（Operating System，简称OS）Linux（推荐）/ macOS / Windows（WSL2）
- GPU（图形处理器/图形加速卡）支持CUDA的GPU（推荐，CPU也可运行）
- Gemini APIGoogle AI Studio API密钥
1️⃣ 获取项目
git clone https://github.com/dustland/genesis-mcp.git
cd genesis-mcp2️⃣ 环境设置
# Gemini APIキーを設定
cp .env.example .env
# .envファイルを編集してGEMINI_API_KEY=your_api_key_here を設定
# または、setup.pyを使って設定
python setup.py --gemini-key YOUR_KEY # APIキー設定
# 自動セットアップ
python setup.py --all
# 環境チェック
python setup.py --check3️⃣ VNC环境设置（用于远程显示）
# VNC環境構築
python start_vnc.py --start
# VNC接続確認
python start_vnc.py --status
# 接続: VNCクライアントで localhost:59004️⃣ 执行
# 仮想環境アクティベート
source .venv/bin/activate # Linux/macOS
.venv\Scripts\activate # Windows
# インタラクティブモード（推奨）
python genesis_client.py
# デモ実行
python genesis_client.py --demo
# MCPサーバー起動
python genesis_server.py______________________________________________________________________
使用示例
基本使用方法
$ python genesis_client.py
🤖 Genesis MCP クライアント起動
📝 シミュレーション内容を入力: 赤い球体が3つ落下するシミュレーション
🧠 Gemini AIでコード生成中...
🔄 Genesis シミュレーション実行中...
✅ シミュレーション完了 - VNCで3D表示を確認してください演示模式
$ python genesis_client.py --demo
🎪 Genesis MCP デモ実行
📺 デモ 1/3: 赤い球体が落下するシミュレーション
📺 デモ 2/3: 2つの箱が接触するシミュレーション
📺 デモ 3/3: 球体が箱の上を転がるシミュレーション
✅ 全デモ完了生成的代码示例
输入“蓝色盒子与红色球碰撞的模拟”
Gemini AI生成代码:
import genesis as gs
# 初期化（GPU使用）
gs.init(backend=gs.gpu)
# シーン作成（VNC最適化）
scene = gs.Scene(
viewer_options=gs.options.ViewerOptions(
resolution=(800, 600),
max_FPS=15,
camera_pos=(3.0, 2.0, 2.0)
),
show_viewer=True
)
# 地面
plane = scene.add_entity(gs.morphs.Plane())
# 青い箱
box_material = gs.materials.Rigid(color=(0.0, 0.0, 1.0))
box = scene.add_entity(
gs.morphs.Box(size=(1, 1, 1)),
pos=(0, 0, 2),
material=box_material
)
# 赤い球
sphere_material = gs.materials.Rigid(color=(1.0, 0.0, 0.0))
sphere = scene.add_entity(
gs.morphs.Sphere(radius=0.5),
pos=(2, 0, 4),
material=sphere_material
)
# シーンビルド
scene.build()
# 物理シミュレーション実行
for i in range(1000):
scene.step()______________________________________________________________________
项目结构
genesis-mcp/
├── 🔧 コアファイル
│ ├── genesis_client.py # メインクライアント
│ ├── genesis_server.py # MCPサーバー
│ ├── genesis_templates.py # AIテンプレートシステム
│ ├── setup.py # 統合セットアップ
│ └── start_vnc.py # VNC環境管理
│
├── 📦 パッケージ
│ ├── src/genesis_mcp/
│ │ ├── models.py # データモデル
│ │ └── services/
│ │ ├── simulation.py # シミュレーション制御
│ │ └── gemini_service.py # Gemini AI統合
│ │
├── ⚙️ 設定ファイル
│ ├── pyproject.toml # パッケージ設定
│ ├── .env.example # 環境変数テンプレート
│ └── uv.lock # 依存関係ロック
│
├── � ドキュメント
│ ├── docs/ # 詳細ドキュメント
│ ├── VNC_OPTIMIZATION_GUIDE.md # VNC最適化ガイド
│ └── USAGE_GUIDE.md # 使用方法詳細
│
└── 🧪 テスト
└── tests/
├── integration_test.py # 統合テスト
└── test_services.py # サービステスト______________________________________________________________________
设置选项
安装选项
# 個別セットアップ
python setup.py --env # 仮想環境のみ
python setup.py --vnc # VNC環境のみ
python setup.py --genesis # Genesis Worldのみ
python setup.py --gemini-key YOUR_KEY # APIキー設定
# 環境確認
python setup.py --checkVNC设置
# VNC詳細操作
python start_vnc.py --start # VNC開始
python start_vnc.py --stop # VNC停止
python start_vnc.py --status # 状況確認
python start_vnc.py --cleanup # クリーンアップ
python start_vnc.py --display # 利用可能ディスプレイ客户端选项
# 表示モード指定
python genesis_client.py --vnc # VNC表示モード
python genesis_client.py --gui # 直接GUI表示
python genesis_client.py --web # Web表示（実験的）
# デバッグモード
python genesis_client.py --debug
python genesis_server.py --debug______________________________________________________________________
VNC远程连接
Windows → Linux 服务器
# 1. サーバー側でVNC起動
python start_vnc.py --start
# 2. SSH接続でポートフォワーディング
ssh -L 5900:localhost:5900 user@your-server
# 3. WindowsのVNCクライアントで接続
# 接続先: localhost:5900连接流程
Windows PC (VNC Viewer)
↓ SSH Tunnel (Port 5900)
Linux Server (VNC Server)
↓ DISPLAY :1
Genesis World 3D Viewer (800x600@15fps)
↓ 最適化転送
Windows PC (リアルタイム3D表示)______________________________________________________________________
API 参考
MCP服务器工具
run_simulation
运行Genesis World模拟
参数:
codePython代码（Gemini生成或自定义）description模拟说明options执行选项
get_simulation_template
基于模板的代码生成
参数：
keywords搜索关键词style模板样式
MCP服务器资源
world_info://features
Genesis World功能信息
simulation_state://current
当前的模拟状态
______________________________________________________________________
故障排除
无法连接VNC
# VNC再起動
python start_vnc.py --cleanup
python start_vnc.py --start
# ポート確認
netstat -tlnp | grep :5900
# ファイアウォール確認
sudo ufw allow 5900未被提及的创世纪世界
# DISPLAY設定確認
echo $DISPLAY
# X11テスト
export DISPLAY=:1
xclock
# Genesis Worldテスト
python -c "import genesis as gs; print('Genesis OK')"Gemini AI连接错误
# APIキー確認
cat .env | grep GEMINI_API_KEY
# 接続テスト
python -c "
import os
import google.generativeai as genai
genai.configure(api_key=os.getenv('GEMINI_API_KEY'))
print('Gemini API接続OK')
"性能问题
# GPU確認
python -c "import torch; print(f'CUDA: {torch.cuda.is_available()}')"
# VNC最適化確認
python start_vnc.py --status
# 解像度調整（pyproject.tomlで設定可能）
# resolution=(800, 600) → (640, 480) for better performance______________________________________________________________________
开发
开发环境设置
# 開発用依存関係インストール
uv pip install -e ".[dev]"
# テスト実行
python -m pytest tests/
# 統合テスト
python tests/integration_test.py
# コード品質チェック
black src/ tests/
isort src/ tests/
flake8 src/ tests/新增功能
- 添加模板:
genesis_templates.py添加模式 - 优化AI提示词:
src/genesis_mcp/services/gemini_service.py进行编辑 - VNC优化:
start_vnc.pyx11vnc参数调整
分析画像/特征分析
# パフォーマンス計測
python -m cProfile -o profile.stats genesis_client.py --demo
# メモリ使用量監視
python -m memory_profiler genesis_client.py______________________________________________________________________
系统要求
最低要求
- 中央处理器（CPU）Intel/AMD x64 或 Apple Silicon
- 随机存取存储器（RAM）4GB以上
- 存储2GB以上
- 网络互联网连接（用于Gemini API）
推荐要求
- CPU（中央处理器）4核以上
- 随机存取存储器（RAM）8GB以上
- GPU（图形处理器）支持CUDA的GPU（RTX系列、GTX 1060及以上）
- 网络稳定的宽带连接
对应操作系统
- ✅ Ubuntu（乌班图） 20.04+（推荐）
- ✅ CentOS/RHEL（注：CentOS 和 RHEL 都是红帽（Red Hat）公司旗下的操作系统，CentOS 是基于 RHEL 源代码构建的开源操作系统，而 RHEL 是商业版操作系统） 8+
- ✅ macOS（苹果电脑操作系统） 12岁以上
- ⚠️ Windows （通过WSL2实现有限制的支持）
______________________________________________________________________
许可证
这个项目包括以下组件：
- Genesis MCP，根据MIT许可证授权。
- 创世纪（或泛指“起源”、“开端”），根据Apache License 2.0授权。
版权所有 © 2024 Genesis 作者们 修改及额外代码 © 2025 Shota Chida。
______________________________________________________________________
致谢
- Google Gemini高品质AI代码生成
- 模型上下文协议标准化的AI通信协议
______________________________________________________________________
🎬 体验Genesis MCP中AI创造的下一代物理模拟！