Revit MCP (Oakplank)

RevitMCP

RevitMCP是一个pyRevit扩展和一个Python服务器，允许AI客户端在实时Revit会话中工作。

它支持两种使用方式：

• Web用户界面位于 http://127.0.0.1:8000
• 克劳德桌面本地MCP通过stdio

存储库布局说明：此存储库根是pyRevit扩展根。如果手动从源代码安装，则应命名签出目录本身 RevitMCP.extension.

工具

RevitMCP公开了29个工具：

需求

• 欧特克 Revit
• pyRevit
• Python 3.7+可用作 python 如果您想直接或通过Claude Desktop运行外部服务器
• 使用RevitMCP时打开的Revit项目

表面模式

RevitMCP有两个服务器表面：

• web：浏览器UI位于 http://127.0.0.1:8000
• mcp：克劳德桌面的stdio服务器

一 server.py 该过程一次运行一个曲面。

手动切换：

python lib\RevitMCP_ExternalServer\server.py --surface web
python lib\RevitMCP_ExternalServer\server.py --surface mcp

如果使用pyRevit启动器，它将从以下位置读取首选曲面：

%USERPROFILE%\Documents\RevitMCP\user_data\revitmcp_settings.json

{
  "preferences": {
    "server_surface": "web"
  }
}

如果你想同时使用Web UI和Claude Desktop，它们需要作为单独的进程运行。

安装RevitMCP

1. 安装pyRevit： pyRevit安装程序
2. 选择以下pyRevit扩展根之一：

- %APPDATA%\pyRevit\Extensions - %PROGRAMDATA%\pyRevit\Extensions

1. 将此存储库直接克隆到名为的文件夹中 RevitMCP.extension 根下：

git clone https://github.com/oakplank/RevitMCP.git "%APPDATA%\pyRevit\Extensions\RevitMCP.extension"

1. 如果下载ZIP，请将存储库内容解压缩到名为的文件夹中 RevitMCP.extension 在同一个扩展根下。
2. 重新加载pyRevit或重新启动Revit。

文件夹名称很重要：pyRevit通过以结尾的文件夹发现扩展名 .extension.

启用Revit路线

1. 打开Revit。
2. 首选 pyRevit -> Settings.
3. 启用路由服务器。
4. 重新启动Revit。
5. 如果Windows要求，允许防火墙访问。

默认的Revit Routes端口通常为 48884.

快速入门：Web UI

1. 打开Revit项目。
2. 在Revit中，单击 RevitMCP -> Server -> Launch RevitMCP.
3. 打开 http://127.0.0.1:8000.
4. 在web UI中添加任何所需的模型或API设置。
5. 尝试： Get Revit project info

快速入门：克劳德桌面

1. 安装克劳德桌面： https://claude.ai/download
2. 在Claude Desktop中，转到 Settings -> Developer -> Local MCP Servers -> Edit Config.
3. 添加 revitmcp 到您的Claude配置。

如果您的Claude配置已存在，请保持当前配置 preferences 以及其他MCP服务器。仅添加 revitmcp 在...之下 mcpServers.

如果复制下面的完整示例，请更新 preferences 值以匹配您自己的Claude Desktop设置。

{
  "mcpServers": {
    "revitmcp": {
      "command": "python",
      "args": [
        "C:\\Program Files\\pyRevit-Master\\extensions\\RevitMCP.extension\\lib\\RevitMCP_ExternalServer\\server.py",
        "--surface",
        "mcp"
      ]
    }
  },
  "preferences": {
    "chromeExtensionEnabled": true,
    "coworkScheduledTasksEnabled": true,
    "ccdScheduledTasksEnabled": true,
    "sidebarMode": "chat",
    "coworkWebSearchEnabled": true
  }
}

1. 替换示例 server.py 路径与机器上的实际路径。
2. 如果 python 不起作用，请用完整路径替换它 python.exe.
3. 保存文件并完全重新启动Claude Desktop。
4. 重新开放 Settings -> Developer -> Local MCP Servers 并确认 revitmcp 显示 running.
5. 尝试： Get Revit project info

预计克劳德桌面屏幕之后 revitmcp 已配置：

故障排除

revitmcp 未显示在Claude Desktop中

• 检查您的Claude配置是否是有效的JSON。
• 确保 server.py 路径是绝对存在的。
• 如果 python 未找到，请使用完整路径 python.exe.
• 从系统托盘中完全退出Claude Desktop并重新打开。
• 检查 %APPDATA%\Claude\logs.

克劳德桌面可以看到 revitmcp 但工具不起作用

• 确保Revit已打开并加载了项目。
• 确保pyRevit路由已启用。
• 启用Routes后重新启动Revit。
• 打开 View Logs 为了 revitmcp 在克劳德桌面。

Web UI或服务器启动问题

• 检查 %USERPROFILE%\Documents\RevitMCP\server_logs
• 启动日志： server_startup_error.log
• 应用程序日志： server_app.log