BC

barbosaihan/civil3d-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

46 stars 20 forks 品質 82 トレンド 21MIT

AI-パワード・土木3Dモデリング

概要

人工知能アシスタントがAutodesk Civil 3D の内部に直接アクセスできる MCP サーバー。 固定ツールの代わりに、AIはフルAPIアクセスで実行するコードを生成します。 1。 → 文書化されたC#コードテンプレート2を取得します。 → パラメータに塗りつぶし、パターン3を組み合わせます。 → ビア Civil3d execute or Civil3d query 4。 → 完全なAPIアクセス5で内分3Dで → AIに戻る スキルは、スキルのC#コードテンプレートを文書化/: Civil3d execute または Civil3d query で実行されるコードは、次のアクセスがあります。 民事3Dの名称空間はすべて自動インポートされます。 Roslyn サンドボックスブロック: - プロセス実行 (Process.Start) - ファイル削除 (File.Delete) - ネットワークリクエスト (HttpClient, Sockets) - レジストリアクセス - 動的アセンブリ読み込み 民事3D API操作は許可されます.

概要(AI 翻訳)

AI アシスタントをwrite と実行できるようにする MCP サーバー Autodesk Civil 3D 内で直接 C# コード を実行します。 固定ツールの代わりに、AIはフルAPIアクセスで実行するコードを生成します。

アーキテクチャ

#3 メタツール

| ツール | 目的 | 安全 | |------------------------------------| | [civil3d_execute | C#コードをwriteアクセス(トランザクションコミット)で実行 | ⚠️ 図面を修正 | | [civil3d_query | C#コードの実行読み取り専用(コミットなし) | ✅ 副作用なし | | [civil3d_skills | ブラウズ/search/read code スキルテンプレート | ✅ メタデータのみ |

使い方

1。AIはスキルを読み取ります → 文書化されたC#コードテンプレートを取得する 2.AIはコードを適応させます → パラメータに塗りつぶし、パターンを組み合わせます 3。AIはコードを送信します → civil3d_execute または [civil3d_query 4。Roslynは+実行 → 完全なAPIアクセスと内分岐3Dをコンパイル 5。結果はJSONとして戻ります → AIに戻る

##例 インターアクション

##スキルライブラリ

[skills/ で C# コードテンプレートを記述するスキル:

##スクリプトグローバル

[civil3d_execute または civil3d_query] で実行されるコードは、次のアクセスがあります。

| 会社概要 | お問い合わせ | [[T8] | [Document | アクティブオートCADドキュメント |

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Civil 3D MCP Server — Code Execution Architecture

An MCP server that enables AI assistants to write and execute C# code directly inside Autodesk Civil 3D. Instead of fixed tools, the AI generates code that runs with full API access.

Architecture

┌─────────────────┐     stdio      ┌──────────────────┐     TCP/JSON-RPC    ┌──────────────────┐
│   AI Assistant   │ ◄────────────► │  MCP Server (TS) │ ◄──────────────────► │  Civil 3D Plugin │
│ (Claude, Cline)  │               │   3 meta-tools    │     port 8080       │  Roslyn Engine   │
└─────────────────┘               └──────────────────┘                      └──────────────────┘
                                         │                                         │
                                    Skills Library                           C# Code Execution
                                   (.skill.md files)                      (full Civil 3D API)

3 Meta-Tools

Tool Purpose Safety
civil3d_execute Execute C# code with write access (transaction committed) ⚠️ Modifies drawing
civil3d_query Execute C# code read-only (no commit) ✅ No side effects
civil3d_skills Browse/search/read code skill templates ✅ Metadata only

How It Works

  1. AI reads a skill → Gets a documented C# code template
  2. AI adapts the code → Fills in parameters, combines patterns
  3. AI sends code → Via civil3d_execute or civil3d_query
  4. Roslyn compiles + runs → Inside Civil 3D with full API access
  5. Results return as JSON → Back to the AI

Example Interaction

User: "What surfaces are in my drawing?"

AI: Uses civil3d_query with:
  var surfaces = new List();
  foreach (ObjectId id in CivilDoc.GetSurfaceIds()) {
    var s = Transaction.GetObject(id, OpenMode.ForRead) as TinSurface;
    surfaces.Add(new { s.Name, s.Layer });
  }
  return surfaces;

Result: [{ "Name": "EG", "Layer": "C-TOPO-EG" }, ...]

Skills Library

Skills are documented C# code templates in skills/:

skills/
├── surfaces/           # Surface operations
├── alignments/         # Alignment + station/offset
├── points/             # COGO points
├── geometry/           # Lines, polylines, text
├── drawing/            # Drawing info
└── workflows/          # Complex multi-object operations

Script Globals

Code executed via civil3d_execute or civil3d_query has access to:

Global Type Description
Document Document Active AutoCAD document
CivilDoc CivilDocument Active Civil 3D document
Database Database Document database
Transaction Transaction Active transaction
Editor Editor Document editor

All Civil 3D namespaces are auto-imported.

Setup

1. Build MCP Server

npm install && npm run build

2. Build Plugin

GitHub で README 全文を見る

インストール

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

Open the repository installation guide MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "civil3d": { "command": "node", "args": ["/path/to/civil3d-mcp/build/index.js"] } } }