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 已配置：

Claude Desktop Local MCP settings showing Developer selected and the revitmcp server running

故障排除

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