SH

suradath/hermes-blender-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

0 stars 0 forks 质量 75 趋势 14MIT

MCP Server ให้ Hermes Agent สั่งงาน Blender 5.2 ผ่าน bpy — 12 เครื่องมือ ·คลังของฟรี CC0 ·ตัวสร้างโมเดลโพลิกอน ·ทดสอบ 756 ข้อ

概览

MCP Server (stdio) ที่เชื่อม เข้ากับ ผ่าน bpy ให้ AI อ่านฉาก สร้าง/ขยับวัตถุ ใส่สี และรันสคริปต์ได้จริงจากในแชท 🎯 ทดสอบอัตโนมัติผ่าน + (Hermes MCP Add → เชื่อมต่อได้ เห็นทั้ง 12 เครื่องมือ) ⏳ — เครื่องง ��ี่พัฒนาไม่มี Blender ติดตั้ง (ดูหัวข้อ ทดสอบอะไรแล้ว / ยังไม่ได้ทดสอบอะไร) *🏠 — 88 ชิ้น สร้างจากเรขาคณิตจริง (ไม่ได้ปั้นมือ · ไม่ได้ใช้ภาพจาก AI) เสายกพื้น ·หลังคาซ้อนชั้นชัน 40.6° ·หน้าบัน ·ป้านลม ·ช่อฟ้าโค้ง ·ระเบียง ·บันได — ดูในคู่มือ §10* MCP สื่อสารผ่าน stdio แต่ blender -b พ่นข้อความต้อนรับ/บันทึกของตัวเองลง ตั้งแต่ก่อนสคริปต์จะได้รัน ถ้าให้ MCP server รันใน Blender เอง ไคลเอนต์ฌค ��ะอ่านเจอขยะ ก่อน JSON แรก → พังทันที (ไฟล์นี้จึงยืนยันได้วุ่ � ตอนสตาร์ต) สะพานจึงใช้ และปล่อยให้ stdout ของ Blender เป็นแค่บันทึก เอกสารและรายงานบั๊กของชุมชนยืนยันตรงกัน: เรียก BPY จาก thread อื่นได้ และ ด้วย (แ ��ี PR จริงที่แก้เรื่องนี้ — เซิร์ฟเวอร์ที่พึ่ง timer จะค้างทุกคําสั่งในโหมด headless) การออกแบบจึงแยกเป็นสองโหมดตามที่ bpy บังคับ: blender_bridge。

概述(AI 翻译)

MCP Server ตัวเดียวที่เชื่อม Hermes Agent เข้ากับ Blender 5.2 ให้ AI อ่านฉาก สร้าง/ขยับวัตถุ ใส่สี ถ่ายภาพหน้าจอ และรันสคริปต์ bpy ได้จากในแชท

สรุป 30 วินาที

  • ต้องมี: Blender 5.2 + Python 3.10 ขึ้นไป (ของเครื่อง ไม่ใช่ของ Blender)
  • ติดตั้ง: ดับเบิลคลิก install-windows.bat (หรือ 3 คําสั่งบน Linux/macOS)
  • ใช้งาน: hermes mcp add blender ... แล้วสั่งเป็นภาษาธรรมชาติ
  • ไม่ต้อง ติดตั้ง add-on ใน Blender และ ไม่ต้อง pip install อะไรลง Blender เลย

สถานะ: ชุดทดสอบอัตโนมัติ 811 ข้อ (11 ชุด) ผ่านหมด · ⭐ --selftest --deep ผ่านครบ 14/14 บน Blender 5.2.2 จริง (Windows 11, 17 ต.ค. 2026) ·ทดสอบอะไรแล้ว / ยังไม่ได้ทดสอบอะไร

🏠 บ้านทรงไทยโพลิกอน — 88 ชิ้น สร้างจากเรขาคณิตจริง (ไม่ได้ปั้นมือ · ไม่ได้ใช้ภาพจาก AI) เสายกพื้น ·หลังคาซ้อนชั้นชัน 40.6° ·หน้าบัน ·ป้านลม ·ช่อฟ้าโค้ง ·ระเบียง ·บันได — ดูวิธีสร้างในคู่มือ §10


⚡ เริ่มเร็ว (5 นาที)

Windows 11:

Linux / macOS:

เสร็จแล้วเปิดเซสชันใหม่ แล้วลองสั่ง: “ใช้ Blender สร้างลูกบาศก์ที่ (0,) 0,3) ใส่สีแดง แล้วบอกว่าฉากมีอะไรบ้าง”

⚠️ กับดักอันดับ 1: --args ต้องอยู่ ท้ายสุด ของคำสั่ง hermes mcp add เสมอ —

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Hermes Blender MCP — ให้ AI สั่งงาน Blender ได้จริง

MCP Server ตัวเดียวที่เชื่อม Hermes Agent เข้ากับ Blender 5.2 ให้ AI อ่านฉาก สร้าง/ขยับวัตถุ ใส่สี ถ่ายภาพหน้าจอ และรันสคริปต์ bpy ได้จากในแชท

สรุป 30 วินาที

  • ต้องมี: Blender 5.2 + Python 3.10 ขึ้นไป (ของเครื่อง ไม่ใช่ของ Blender)
  • ติดตั้ง: ดับเบิลคลิก install-windows.bat (หรือ 3 คำสั่งบน Linux/macOS)
  • ใช้งาน: hermes mcp add blender ... แล้วสั่งเป็นภาษาธรรมชาติ
  • ไม่ต้อง ติดตั้ง add-on ใน Blender และ ไม่ต้อง pip install อะไรลง Blender เลย

สถานะ: ชุดทดสอบอัตโนมัติ 811 ข้อ (11 ชุด) ผ่านหมด · ⭐ --selftest --deep ผ่านครบ 14/14 บน Blender 5.2.2 จริง (Windows 11, 17 ต.ค. 2026) · ทดสอบอะไรแล้ว / ยังไม่ได้ทดสอบอะไร

🏠 บ้านทรงไทยโพลิกอน — 88 ชิ้น สร้างจากเรขาคณิตจริง (ไม่ได้ปั้นมือ · ไม่ได้ใช้ภาพจาก AI) เสายกพื้น · หลังคาซ้อนชั้นชัน 40.6° · หน้าบัน · ป้านลม · ช่อฟ้าโค้ง · ระเบียง · บันได — ดูวิธีสร้างในคู่มือ §10


⚡ เริ่มเร็ว (5 นาที)

Windows 11:

cd C:\Hermes-blender-mcp
install-windows.bat                       :: 1) ติดตั้ง (สร้าง venv + ตรวจ Blender)
run-hermes-blender-mcp.bat --selftest     :: 2) ทดสอบเปิด Blender จริง
hermes mcp add blender --command "C:\Hermes-blender-mcp\.venv\Scripts\python.exe" ^
  --connect-timeout 120 --args C:\Hermes-blender-mcp\blender_mcp_server.py   :: 3) ต่อ Hermes

Linux / macOS:

cd Hermes-blender-mcp
python3 -m venv .venv && ./.venv/bin/pip install -r requirements.txt
./.venv/bin/python blender_mcp_server.py --check
hermes mcp add blender --command "$PWD/.venv/bin/python" --connect-timeout 120 \
  --args "$PWD/blender_mcp_server.py"

เสร็จแล้วเปิดเซสชันใหม่ แล้วลองสั่ง: “ใช้ Blender สร้างลูกบาศก์ที่ (0,0,3) ใส่สีแดง แล้วบอกว่าฉากมีอะไรบ้าง”

⚠️ กับดักอันดับ 1: --args ต้องอยู่ ท้ายสุด ของคำสั่ง hermes mcp add เสมอ — ถ้ามี option อื่นต่อท้าย มันจะถูกกลืนเป็นอาร์กิวเมนต์ของเซิร์ฟเวอร์ แล้วได้แค่ Connection closed (รายละเอียดใน ขั้นที่ 5)


📚 สารบัญ

  1. มันทำอะไรได้
  2. ก่อนติดตั้ง — ต้องมีอะไร
  3. ติดตั้งทีละขั้น (ละเอียด)
  4. ต่อเข้ากับ Hermes — ข้อมูลเชิงลึก
  5. ลองสั่งงานครั้งแรก
  6. ทำไมต้องแยกเป็นสองโปรเซส
  7. เครื่องมือทั้งหมด 13 ตัว
  8. ความปลอดภัยของ execute_blender_script
  9. แก้ปัญหา
  10. ทดสอบ / สถานะความน่าเชื่อถือ
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "blender": { "command": "C:\\Hermes-blender-mcp\\.venv\\Scripts\\python.exe", "args": ["C:\\Hermes-blender-mcp\\blender_mcp_server.py"] } } }