{"id":32722679,"url":"https://github.com/piggyandrew/revit_mcp_dotnet_template","last_synced_at":"2026-04-12T18:57:06.804Z","repository":{"id":322109580,"uuid":"1088232080","full_name":"PiggyAndrew/revit_mcp_dotnet_template","owner":"PiggyAndrew","description":"revit mcp template with dotnet","archived":false,"fork":false,"pushed_at":"2025-11-02T15:44:26.000Z","size":147,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-02T17:26:53.607Z","etag":null,"topics":["demo","dotnet","mcp","revit","template"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PiggyAndrew.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-02T15:19:17.000Z","updated_at":"2025-11-02T15:45:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/PiggyAndrew/revit_mcp_dotnet_template","commit_stats":null,"previous_names":["piggyandrew/revit_mcp_dotnet_template"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/PiggyAndrew/revit_mcp_dotnet_template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiggyAndrew%2Frevit_mcp_dotnet_template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiggyAndrew%2Frevit_mcp_dotnet_template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiggyAndrew%2Frevit_mcp_dotnet_template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiggyAndrew%2Frevit_mcp_dotnet_template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PiggyAndrew","download_url":"https://codeload.github.com/PiggyAndrew/revit_mcp_dotnet_template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PiggyAndrew%2Frevit_mcp_dotnet_template/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":282365372,"owners_count":26657259,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-02T02:00:06.609Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["demo","dotnet","mcp","revit","template"],"created_at":"2025-11-02T22:01:11.617Z","updated_at":"2025-11-02T22:01:58.834Z","avatar_url":"https://github.com/PiggyAndrew.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Revit MCP DotNet Project\n\nLanguage: [中文](README.zh-CN.md) | English\n\nThis project contains two main components: a Revit MCP (Mcp) server and a Revit Plugin to communicate with it.\n\n## Revit MCP Project\n\nThe Revit MCP project (`NET.Mcp.Server`) is a .NET Core application that acts as a bridge between a main application and the Revit application. It listens for commands and executes them within the Revit environment.\n\n### Configuration\n\nThe MCP server is configured via the `mcpConfig.json` file located in `src\\NET.App.Revit\\NET.Mcp.Server\\`. This file defines how to launch the MCP server processes.\n\nFor example, to configure it for the `trae` environment, you would set the project path to your local machine's path.\n\n**Example `mcpConfig.json`:**\n\n```json\n{\n  \"mcpServers\": {\n    \"revit\": {\n      \"command\": \"dotnet\",\n      \"args\": [\n        \"run\",\n        \"--project\",\n        \"d\\\\yourpath\\\\revit_mcp_dotnet_template\\\\src\\\\NET.App.Revit\\\\NET.Mcp.Server\",\n        \"--no-build\"\n      ],\n      \"env\": {}\n    }\n  }\n}\n```\n\n**Note:** Make sure the `--project` path points to the correct location of the `NET.Mcp.Server` project on your machine.\n\n### Running the Server\n\nTo run the MCP server, you can execute the command defined in your `mcpConfig.json` from your terminal. Based on the example above, you would run:\n\n```bash\ndotnet run --project d:\\GitHub\\revit_mcp_dotnet-main\\src\\NET.App.Revit\\NET.Mcp.Server\n```\n\nThis will start the server, which will then wait for the Revit plugin to connect.\n\n## Revit Plugin Project\n\nThe Revit Plugin (`NET.App.Revit`) is an add-in for Autodesk Revit that connects to the MCP server and allows for external control of Revit.\n\n### Usage in Revit\n\n1.  **Build the Project**: Build the `NET.App.Revit.sln` solution to generate the plugin DLLs.\n2.  **Load the Plugin in Revit**:\n    *   Copy the generated `.addin` file and the associated DLLs to the Revit Add-ins folder (e.g., `%APPDATA%\\Autodesk\\Revit\\Addins\\2022`).\n    *   Start Autodesk Revit.\n3.  **Run the Plugin**:\n    *   Once loaded, you will find new commands in the Add-ins tab in Revit.\n    *   Use the \"Start Server\" command (or similar) to initiate the connection to the running MCP server.\n\n### Version Compatibility\n\nThis plugin is currently configured and tested for **Revit 2022**.\n\nIf you need to use it with other versions of Revit (e.g., 2021, 2023, 2024), you will need to:\n1.  Update the Revit API references in the `.csproj` file.\n2.  Adjust the `.addin` file to target the desired Revit version.\n3.  Rebuild the project.\n\n## Examples Included\n\n- MCP Server (.NET): Located at `src/NET.App.Revit/NET.Mcp.Server`. Includes a sample `mcpConfig.json` (with a Trae example) to launch the server locally.\n- Revit Plugin (.NET): Located at `src/NET.App.Revit/NET.App.Revit`. Contains the add-in project and instructions to load it in Revit.\n\nBoth examples are implemented on the .NET side. The plugin is verified with Revit 2022; other versions require manual configuration of API references and the `.addin` target.\n\n## Quick Links\n\n- Detailed Revit app guide (English): `src/NET.App.Revit/README.md`\n- 详细中文指南：`src/NET.App.Revit/README.zh-CN.md`\n\n## Trae MCP Configuration\n\nBelow is where to paste the MCP config JSON in Trae. Toggle the server after adding it.\n\n![Trae MCP Config Dialog](docs/images/trae-mcp-config.png)\n\n### How to Use `mcpConfig.json` in Trae\n\n- Open Trae and go to the `MCP` tab.\n- Click `+ Add` → select `Manual Config (JSON)`.\n- Paste the JSON from your `mcpConfig.json` (see example above).\n- Click `Confirm` and ensure the new server appears in the list.\n- Toggle the server ON to start it.\n\n### Start Project (Step-by-Step)\n\n- Prerequisites: install `'.NET 8 SDK'` and `Revit 2022` (other versions need manual plugin config).\n- Build plugin: open `src/NET.App.Revit/NET.App.Revit.sln`, build Release, copy the `.addin` and DLLs to `%APPDATA%\\Autodesk\\Revit\\Addins\\2022`.\n- Start MCP Server (CLI): run `dotnet run --project d:\\GitHub\\revit_mcp_dotnet-main\\src\\NET.App.Revit\\NET.Mcp.Server`.\n- Start MCP Server (Trae): add the JSON via the MCP tab (as above) and toggle ON.\n- Launch Revit: open Revit, the plugin appears under `Add-ins`. Use the command to connect to the running MCP server.\n- Verify: execute a simple command via your MCP client or observe logs to confirm the Revit session is controlled.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiggyandrew%2Frevit_mcp_dotnet_template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpiggyandrew%2Frevit_mcp_dotnet_template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpiggyandrew%2Frevit_mcp_dotnet_template/lists"}