内容
# Aeclyra Revit 2018.3 MCP
Aeclyra 是 SCode 的迭代版本：面向 **Autodesk Revit 2018.3** 的本地 MCP（Model Context Protocol）服务。它通过本机回环连接让支持 MCP 的 AI 客户端读取和操作当前 Revit 项目。
> 仅支持 Windows x64 和 Revit 2018.3（API 18.3）。不支持 Revit 2018.0–2018.2 或 2019 及后续版本。
## 功能
- 20 个项目读取、查询、预览与变更确认工具
- 仅监听 `127.0.0.1:48180`，不暴露到局域网
- Aeclyra Ribbon：服务启停、工具设置、内建模型转换常规模型、交互式管道自动连接
- 内建模型转换可选常规模型、体量和自适应常规模型样板，并支持材质和实例参数
- 管道自动连接支持点选/多选，以及当前 3D 视图剖面框两种来源；按数量最多的系统确定目标，剖面框模式以每批不超过 250 根、相邻区域重叠的方式执行
- 立管与水平管生成弯头且平面轴线偏位时固定立管，只移动水平管对齐；只有三通规则允许整体移动立管
- 提供无需单独安装 Node.js 的 Windows 一键安装程序
## 安装
从 [Releases](../../releases) 下载 `Aeclyra-Revit2018.3-MCP-Setup-*.exe`，关闭 Revit 后运行安装程序。
安装后：
1. 启动 Revit 2018.3。
2. 在 **Aeclyra** Ribbon 中点击“启动/停止服务”。
3. 在 Codex 的 `%USERPROFILE%\.codex\config.toml` 添加：
```toml
[mcp_servers.Aeclyra]
command = "C:\\Users\\<WindowsUser>\\AppData\\Local\\Aeclyra\\Revit2018Mcp\\runtime\\node.exe"
args = ["C:\\Users\\<WindowsUser>\\AppData\\Local\\Aeclyra\\Revit2018Mcp\\server\\build\\index.js"]
```
4. 重启 Codex，并调用 `get_service_status` 验证连接。
完整中文说明见 [部署说明](docs/DEPLOYMENT.zh-CN.md)。
## 从源码构建
前提：Revit 2018.3、.NET Framework 4.6 Targeting Pack、Visual Studio/MSBuild、Node.js 20+，以及用于取得 IronPython 2.7 构建运行库的 RevitPythonShell 2018。最终安装包会携带这些运行库，终端用户不需要另装 PythonShell。
```powershell
.\scripts\Build-Release.ps1 -Version 0.2.0 -RevitInstallDir 'D:\Autodesk_Revit2018\Revit 2018'
```
生成的安装器在 `release\installer`。构建脚本会打包 Node 运行时、服务端依赖、插件和可选本地信任证书。
## 安全
`send_code_to_revit` 可在 Revit 进程内执行 C#。仅在可信的本地开发环境与已备份模型中使用。
## 许可证
[MIT](LICENSE)
