Stgen DXF Editor

VS Code extension for viewing and editing DXF files with built-in AI (MCP) integration.

Features

• DXF Viewer — Babylon.js WebGL rendering, 2D/3D view, layer visibility control
• 43 CAD Commands — AutoCAD-compatible command-line interface (LINE, CIRCLE, MOVE, TRIM, DIMENSION, etc.)
• 15 Entity Types — LINE, CIRCLE, ARC, POLYLINE, TEXT, MTEXT, DIMENSION, LEADER, ELLIPSE, SPLINE, INSERT, HATCH, SOLID, POINT, ATTRIB
• 10 Object Snap Modes — Endpoint, Midpoint, Center, Quadrant, Intersection, Perpendicular, Nearest, Tangent, Extension, Node
• Undo/Redo — Full undo history with DXF save support
• Export — PNG, SVG file export
• 129 MCP Tools — AI-driven CAD operations via Model Context Protocol

Getting Started

1. Install from VS Code Marketplace.
2. Open any .dxf file — the editor activates automatically.

Navigation

Commands

Type command names in the input box at the bottom (e.g. LINE, MOVE, TRIM).

Keyboard Shortcuts

MCP Integration (AI)

Built-in MCP server with 129 tools for AI-driven CAD operations. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible client.

Setup

Automatic (Recommended)

1. Open a DXF file in VS Code.
2. Ctrl+Shift+P > Stgen: Setup MCP Configuration
3. .mcp.json is created in your workspace root automatically.
4. Restart your AI client.

The extension also auto-updates .mcp.json on every activation if the server path changes (e.g., after extension update).

Manual — Claude Code / Cursor / Windsurf

Create .mcp.json in your project root:

{
  "mcpServers": {
    "stgen-dxf-viewer": {
      "command": "node",
      "args": ["<extension-path>/media/mcp-server.js"],
      "env": {
        "STGEN_MCP_PORT": "52789"
      }
    }
  }
}

<extension-path> is the actual extension install path. To get it:

• Run Ctrl+Shift+P > Stgen: Copy MCP Configuration to Clipboard and paste — the path is already filled in.

Typical paths: | OS | Path | |----|------| | Windows | C:\Users\<user>\.vscode\extensions\jeil-structuralengineering-consultants.stgen-<version>\media\mcp-server.js | | macOS | ~/.vscode/extensions/jeil-structuralengineering-consultants.stgen-<version>/media/mcp-server.js | | Linux | ~/.vscode/extensions/jeil-structuralengineering-consultants.stgen-<version>/media/mcp-server.js |

Manual — OpenAI Codex CLI

The extension auto-creates ~/.codex/config.toml on activation. To configure manually:

[mcp_servers.stgen-dxf-viewer]
command = "node"
args = ["<extension-path>/media/mcp-server.js"]

[mcp_servers.stgen-dxf-viewer.env]
STGEN_MCP_PORT = "52789"

Manual — Google Gemini CLI (Antigravity)

The extension auto-creates ~/.gemini/antigravity/mcp_config.json on activation. To configure manually:

{
  "mcpServers": {
    "stgen-dxf-viewer": {
      "command": "node",
      "args": ["<extension-path>/media/mcp-server.js"],
      "env": {
        "STGEN_MCP_PORT": "52789"
      }
    }
  }
}

Port Configuration

Default port is 52789. To change:

• VS Code setting: stgen.mcpServerPort
• Or environment variable in MCP config: "STGEN_MCP_PORT": "<port>"

Both the VS Code setting and the MCP config env must match.

Verifying Connection

After restarting your AI client, ask: "Use the get_dxf_status tool to check connection."

A successful response confirms the MCP server is connected.

Architecture

AI Client ──stdio──> MCP Server (media/mcp-server.js) ──HTTP:52789──> VS Code Extension ──postMessage──> Webview

Tool Categories (129 tools)

AI Workflow

The server enforces a structured workflow via automatic hints:

get_dxf_summary → write_drawing_spec → begin_transaction → [create/modify] → end_transaction → run_drawing_checks → capture_dxf_view

Configuration

VS Code Commands

Ctrl+Shift+P > Stgen:

Requirements

• VS Code ^1.60.0
• Node.js 22.x (MCP server runtime)

License

MIT — Jeil Structural Engineering Consultants