Vn Sketchup MCP — Development skill for Claude Code

vn-sketchup-mcp

Điều khiển **SketchUp** từ **Claude Code / Codex / Antigravity** (và mọi MCP client dùng stdio) thông qua Model Context Protocol.

Bản Việt hoá + **đã vá lỗi** của [mhyrr/sketchup-mcp](https://github.com/mhyrr/sketchup-mcp): cài phát chạy ngay, không còn crash do lệch phiên bản thư viện `mcp`.

Control SketchUp from Claude Code / Codex / Antigravity via MCP. A fixed, ready-to-run fork of mhyrr/sketchup-mcp.

---

Vá gì so với bản gốc? (What is fixed)

Bản gốc crash ngay khi khởi động server vì:

1. Nó import mcp.server.fastmcp (lớp FastMCP). Nhưng thư viện mcp bản 2.x đã đổi tên FastMCP -> MCPServer, xoá mcp.server.fastmcp. Khi cài bằng uvx/pip không ghim phiên bản, máy kéo về mcp 2.x -> ModuleNotFoundError / crash -> MCP client báo Connection closed.
2. Gói trên PyPI còn dùng API cũ FastMCP(description=...) (đã bỏ), lỗi unexpected keyword argument 'description'.

**Cách vá ở repo này:**

• pyproject.toml ghim mcp[cli]>=1.3,<2 -> luôn cài mcp 1.x còn FastMCP.
• Dùng server.py bản mới (đã đổi sang FastMCP(instructions=...), hợp lệ với mcp 1.x).
• Kèm installer 1 lệnh tự copy plugin Ruby vào mọi bản SketchUp + in sẵn cấu hình cho 3 client.

Kết quả: `uv run vn-sketchup-mcp` chạy ổn, kết nối được SketchUp (đã kiểm chứng trên **SketchUp Pro 2018**, Ruby 2.2.4; và các bản mới hơn).

---

Kiến trúc (How it works)

Gồm 2 phần:

1. Plugin SketchUp (Ruby) — chạy 1 TCP server bên trong SketchUp ở cổng 9876, nhận lệnh và thao tác model.
2. MCP server (Python) — client (Claude Code/Codex/Antigravity) chạy qua stdio; nó nối tới cổng 9876 để đẩy lệnh vào SketchUp.

Claude Code / Codex / Antigravity  <--stdio-->  vn-sketchup-mcp (Python)  <--TCP:9876-->  SketchUp (Ruby plugin)

Yêu cầu

• **uv** (tự tải Python 3.12, không cần cài Python riêng)
• git
• SketchUp (Pro để dùng được đủ Solid Tools; đã test 2018+)

---

Cài đặt (Install)