Metadata-Version: 2.4
Name: 3dsmax-mcp
Version: 1.5.1
Summary: MCP server for AI agents to control Autodesk 3ds Max
Project-URL: Homepage, https://github.com/cl0nazepamm/3dsmax-mcp
Project-URL: Repository, https://github.com/cl0nazepamm/3dsmax-mcp
Project-URL: Issues, https://github.com/cl0nazepamm/3dsmax-mcp/issues
Project-URL: Changelog, https://github.com/cl0nazepamm/3dsmax-mcp/blob/master/docs/CHANGELOG.md
Author-email: clone - m3org <cl0nazepam@proton.me>
License: MIT License
        
        Copyright (c) 2025 clone - m3org
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: 3ds-max,3dsmax,agent,ai,archviz,autodesk,maxscript,mcp,model-context-protocol,tyflow
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Requires-Dist: mcp[cli]<2.0.0,>=1.0.0
Description-Content-Type: text/markdown

# 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 and full documentation:
**https://github.com/cl0nazepamm/3dsmax-mcp**

## Install

```powershell
pip install 3dsmax-mcp
3dsmax-mcp-install
```

`3dsmax-mcp-install` deploys the native bridge plugin into Autodesk's `ApplicationPlugins`
directory, writes user config, and registers the server with the AI clients it can find.
**Restart 3ds Max afterwards** so the plugin loads.

**Requirements:** Windows · Python 3.12+ · 3ds Max 2023–2027

Manual MCP client setup, tool profiles, safe mode and architecture notes are documented in
[docs/ADVANCED.md](https://github.com/cl0nazepamm/3dsmax-mcp/blob/master/docs/ADVANCED.md).

---

## 中文说明

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

用中文描述你要做的事，智能体调用 **151 个专用 MCP 工具**（核心配置 87 个）直接操作场景——创建物体、
构建材质、驱动修改器与控制器、截取视口、检查插件。不是让 AI 盲写 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**

### 安装

国内建议使用清华 TUNA 镜像，速度更快：

```powershell
pip install 3dsmax-mcp -i https://pypi.tuna.tsinghua.edu.cn/simple
3dsmax-mcp-install
```

`3dsmax-mcp-install` 会把原生桥接插件部署到 Autodesk 的 `ApplicationPlugins` 目录、写入用户配置，
并尽可能自动注册到已安装的 AI 客户端。**装完请重启 3ds Max**，插件才会加载。

**环境要求：** Windows · Python 3.12+ · 3ds Max 2023–2027

国内常用的 **Cline + DeepSeek** 配置方式、建筑可视化与 MMD 动画上手示例、以及其他国内镜像，
见中文文档
[README.zh-CN.md](https://github.com/cl0nazepamm/3dsmax-mcp/blob/master/README.zh-CN.md)。

提 issue 用中文完全可以。
