# 3dsmax-mcp

Connect AI agents to **Autodesk 3ds Max** through the [Model Context Protocol](https://modelcontextprotocol.io).

Ask in natural language; the agent creates objects, builds materials, drives modifiers and
controllers, captures viewports, and inspects plugins through **151 dedicated MCP tools**
(87 in the core profile) — not through blind MAXScript feedback loops.

- **Native bridge** — a C++ plugin for 3ds Max 2023–2027, no MAXScript polling
- **Introspection** — discover arbitrary Max classes, plugin surfaces, and parameters at runtime
- **Deep plugin support** — tyFlow, Data Channel, MCG, OSL, Forest Pack, RailClone, Octane
- **Bundled agent skill** — MAXScript reference shipped for writing your own tools

MIT licensed. Source: **https://github.com/cl0nazepamm/3dsmax-mcp**

---

## ⚠️ Installation

**This package is a name placeholder — `pip install 3dsmax-mcp` does not give you a working
server yet.**

3dsmax-mcp ships with a native 3ds Max bridge plugin (`.gup`) that must be deployed into
Autodesk's `ApplicationPlugins` directory. `pip` cannot do that, so installation runs from the
repository:

```powershell
git clone https://github.com/cl0nazepamm/3dsmax-mcp.git
cd 3dsmax-mcp
uv sync
uv run python install.py
```

Restart 3ds Max, then connect your MCP client. The installer registers the server where it can;
manual client setup is documented in
[docs/ADVANCED.md](https://github.com/cl0nazepamm/3dsmax-mcp/blob/master/docs/ADVANCED.md).

**Requirements:** Windows · Python 3.10+ · [uv](https://docs.astral.sh/uv/) · 3ds Max 2023–2027

---

## 中文说明

**3dsmax-mcp** 通过 [Model Context Protocol](https://modelcontextprotocol.io) 把 AI 智能体接入
**Autodesk 3ds Max**。

用自然语言下达指令，智能体即可创建物体、构建材质、驱动修改器与控制器、截取视口、检查插件——
全部通过 **151 个专用 MCP 工具**（核心配置 87 个）完成，而不是靠反复试错的 MAXScript 脚本循环。

- **原生桥接**：3ds Max 2023–2027 的 C++ 插件，无需 MAXScript 轮询
- **运行时自省**：可发现任意 Max 类、插件接口与参数
- **深度插件支持**：tyFlow、Data Channel、MCG、OSL、Forest Pack、RailClone、Octane
- **内置智能体技能包**：附带 MAXScript 参考文档，方便你编写自己的工具

MIT 开源协议。源码地址：**https://github.com/cl0nazepamm/3dsmax-mcp**

### ⚠️ 安装方式

**本 PyPI 包目前仅用于占位，`pip install 3dsmax-mcp` 还不能直接得到可用的服务器。**

3dsmax-mcp 需要配套的 3ds Max 原生桥接插件（`.gup`），该插件必须部署到 Autodesk 的
`ApplicationPlugins` 目录，pip 无法完成这一步。请从源码安装：

```powershell
git clone https://github.com/cl0nazepamm/3dsmax-mcp.git
cd 3dsmax-mcp
uv sync
uv run python install.py
```

然后重启 3ds Max，并连接你的 MCP 客户端。

**环境要求：** Windows · Python 3.10+ · [uv](https://docs.astral.sh/uv/) · 3ds Max 2023–2027
