AP

autodesk-platform-services/aps-sample-mcp-server-revit-automation

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

10 stars 7 forks 质量 55 趋势 18MIT

Sample MCP server to automate Revit via Automation API using SSA

概览

A sample Model Context Protocol (MCP) remote server (HTTP) that enables AI assistants like Claude to automate Autodesk Revit operations via Automation API using Service-to-Service Authentication (SSA). https://github.com/user-attachments/assets/43a5aabc-d2a3-47ff-a9e1-8bd61d24a81e This is a - an exploratory proof-of-concept developed iteratively. It demonstrates patterns and possibilities but may not follow all production-grade practices. This README was generated by based on analyzing the actual codebase, ensuring documentation matches implementation. This MCP server works with the APS Automation API Revit MCP Tools Sample - the Revit AppBundle that executes the actual tools in Automation API. Deploy that AppBundle to use this MCP server. bridges AI assistants with Autodesk Revit through the Model Context Protocol. It enables headless, scalable automation of Revit operations on cloud-hosted models (ACC/BIM360) without manual interaction.

README

以下为原文 README 节选,完整内容请查看原文。

Sample MCP Server for Revit Automation

A sample Model Context Protocol (MCP) remote server (HTTP) that enables AI assistants like Claude to automate Autodesk Revit operations via Automation API using Service-to-Service Authentication (SSA).

https://github.com/user-attachments/assets/43a5aabc-d2a3-47ff-a9e1-8bd61d24a81e


⚠️ Disclaimer
This is a vibe-coded sample solution - an exploratory proof-of-concept developed iteratively. It demonstrates patterns and possibilities but may not follow all production-grade practices. This README was generated by GitHub Copilot based on analyzing the actual codebase, ensuring documentation matches implementation.

🔗 Companion Repository
This MCP server works with the APS Automation API Revit MCP Tools Sample - the Revit AppBundle that executes the actual tools in Automation API. Deploy that AppBundle to use this MCP server.


🎯 Overview

MCP Revit Automation bridges AI assistants with Autodesk Revit through the Model Context Protocol. It enables headless, scalable automation of Revit operations on cloud-hosted models (ACC/BIM360) without manual interaction.

Target Audience: AEC Firms, BIM Managers, BIM Coordinators, Developers building AI-powered BIM workflows

Key Features

  • 🔐 SSA Authentication - JWT bearer tokens with RSA signing for service-to-service auth
  • 🏗️ Fluent API - Type-safe model configuration with compile-time validation
  • 📦 Dual JSON Architecture - Separates model context from tool inputs
  • 🤖 MCP Integration - Exposes tools to AI assistants naturally
  • ☁️ Cloud-Native - Works with Autodesk Cloud Models

🔧 Extensible Tool System

  • Easy to add new Revit automation tools
  • Consistent pattern for all operations
  • No core service changes required

🤖 MCP Protocol Support

  • Exposes tools to AI assistants like Claude or VS Code Copilot
  • Natural language to Revit automation
  • HTTP transport for broad compatibility

☁️ Cloud-Native

  • Works with Autodesk Cloud Models (ACC/BIM360) - Workshared and Non-Workshared
  • Scalable workitem submission
  • Automation API for Revit integration

🏛️ Architecture

MCP Client (Claude/VS Code) 
    ↓ MCP Protocol
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →