mcp-server-for-revit

MCP-сервер (Node.js) для взаимодействия с Autodesk Revit из ИИ-ассистентов (Claude, Cursor и др.).

Этот репозиторий содержит две вещи, которые следует различать:

1. Оригинальный MCP (Node-мост) — соответствует экосистеме mcp-servers-for-revit: предоставляет операции Revit как инструменты MCP; сервер общается с официальным плагином Revit по протоколу TCP (по умолчанию порт 8080), а не через WebSocket в этом потоке моста.

2. Расширение этого форка — двойной порт в мосту (REVIT_PLUGIN_PORT / REVIT_SKETCH_PORT) и отдельная надстройка RevitSketchPoC (C# / WPF) в папке revit-plugin/RevitSketchPoC/, которая прослушивает другой порт (по умолчанию 8081) и обрабатывает только инструмент create_house_from_sketch (интерпретация изображения + создание стен/комнат/дверей в Revit) с настраиваемыми в плагине Ollama или Gemini.

[!NOTE] Для полноценной работы вам потребуется оригинальный плагин Revit (порт 8080) и, если вы используете эскизы через MCP или интерфейс, RevitSketchPoC (порт 8081). Инструкции к официальному плагину: mcp-servers-for-revit. Подробности PoC: revit-plugin/RevitSketchPoC/README.md.

Безопасность и Git

• Не коммитьте файлы .env, ключи в JSON или локальные копии с секретами. Репозиторий включает .gitignore для node_modules/, артефактов .NET (bin/ / obj/), .env* и pluginsettings.local.json.

• Файл deploy/pluginsettings.json в PoC должен содержать пустой GeminiApiKey в Git; используйте локальную копию или следуйте примеру 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, TCP-маршрутизатор MCP, Ollama/Gemini, транзакции Revit). Папка samples/RevitSketchPoC/ может существовать как старая ссылка; следуйте README плагина в revit-plugin/RevitSketchPoC/README.md.

Краткий поток:

1. Пользователь отправляет изображение (через ленту Sketch AI PoC или MCP create_house_from_sketch).

2. Плагин вызывает LLM (Ollama или Gemini согласно pluginsettings.json).

3. Структурированный ответ → создание элементов в Transaction в Revit.

Лицензия

MIT