mcp-server-for-revit

用于从 AI 助手（Claude、Cursor 等）与 Autodesk Revit 进行交互的 MCP 服务器（Node.js）。

本仓库包含两部分内容，需要加以区分：

1. “原始” MCP（Node 网桥） — 与 mcp-servers-for-revit 生态系统保持一致：将 Revit 操作公开为 MCP 工具；服务器通过 TCP（默认端口 8080）与官方 Revit 插件通信，而非在此网桥流程中使用 WebSocket。

2. 此分支的扩展 — 网桥中的双端口（REVIT_PLUGIN_PORT / REVIT_SKETCH_PORT）以及 revit-plugin/RevitSketchPoC/ 文件夹中独立的 RevitSketchPoC 加载项（C# / WPF），它监听另一个端口（默认 8081）并仅处理 create_house_from_sketch 工具（图像解释 + 在 Revit 中创建墙体/房间/门），插件中可配置 Ollama 或 Gemini。

[!NOTE] 对于完整流程，你需要原始 Revit 插件（端口 8080），如果使用 MCP 或 UI 进行草图绘制，则需要 RevitSketchPoC（端口 8081）。官方插件说明：mcp-servers-for-revit。PoC 详情：revit-plugin/RevitSketchPoC/README.md。

安全与 Git

• 不要提交 .env 文件、JSON 格式的密钥或包含机密的本地副本。仓库包含针对 node_modules/、.NET 工件（bin/ / obj/）、.env* 和 pluginsettings.local.json 的 .gitignore。

• PoC 的 deploy/pluginsettings.json 文件应在 Git 中保持 GeminiApiKey 为空；请使用本地副本或遵循 pluginsettings.example.json 作为模板。

设置（MCP 客户端）

Claude Code

claude mcp add mcp-server-for-revit -- npx -y mcp-server-for-revit

Claude Desktop — claude_desktop_config.json：

{
    "mcpServers": {
        "mcp-server-for-revit": {
            "command": "npx",
            "args": ["-y", "mcp-server-for-revit"],
            "env": {
                "REVIT_PLUGIN_PORT": "8080",
                "REVIT_SKETCH_PORT": "8081"
            }
        }
    }
}

重启客户端。工具图标表示 MCP 已连接。

双端口，双插件

create_house_from_sketch 工具使用 REVIT_SKETCH_PORT（或请求中的 data.pluginPort）。pluginPort 字段不会发送到 Revit（网桥会将其移除）。其余工具使用 REVIT_PLUGIN_PORT。

支持的 MCP 工具

开发 (Node)

npm install
npm run build

Sketch PoC (C# / WPF)

当前且受支持的实现位于 revit-plugin/RevitSketchPoC/（UI、MCP TCP 路由器、Ollama/Gemini、Revit 事务）。samples/RevitSketchPoC/ 文件夹可能作为旧参考存在；请遵循 revit-plugin/RevitSketchPoC/README.md 中的插件 README。

流程摘要：

1. 用户发送图像（功能区 Sketch AI PoC 或 MCP create_house_from_sketch）。

2. 插件调用 LLM（根据 pluginsettings.json 使用 Ollama 或 Gemini）。

3. 结构化响应 → 在 Revit 的 Transaction 中创建元素。

许可证

MIT