topsolid-automation-mcp

Community Model Context Protocol server for TopSolid® 7 — bring any MCP-compatible AI agent (Claude, ChatGPT-MCP clients, Cursor, Windsurf, JetBrains, VS Code + Copilot, OpenClaw, etc.) into your TopSolid workflow.

Community project. TopSolid® is a registered trademark of TOPSOLID SAS. This repository is an independent, community-maintained MCP server. It is not endorsed by, sponsored by, or affiliated with TOPSOLID SAS. It wraps the publicly documented TopSolid Automation API and indexes the publicly shipped help documentation. A valid TopSolid license is required to run it against a live TopSolid instance.

What is this?

An MCP server written in C# (.NET Framework 4.8) that exposes the TopSolid 7 Automation API as a set of 14 tools any MCP client can call. On top of the raw API, it ships with:

• 224 pre-built recipes — curated C# snippets for the most common CAD/PDM operations (create and replace revolved profiles, create a document from a named template, read mass/volume, set designation, read and edit implicit family catalogs, import any CAD file, export to any format with a guard against empty documents, activate BOM rows, detect drafting scale, ...), browsable with topsolid_list_recipes.
• A 4119-edge type graph of the API (1728 methods, 242 types), queryable by Dijkstra / BFS to discover method chains between any two types.
• A 5809-page help index (EN + FR) in SQLite FTS5 — ask your agent "how does the sheet-metal unfolding command work?" and get the official help excerpt.
• A 2428-command catalog — look up any ribbon/menu command by keyword, get its FullName ready to invoke.
• A dry-run compile check — the script is compiled against the TopSolid assemblies without being run, so hallucinated APIs and syntax errors surface before execution. It uses CSharpCodeProvider (the csc compiler bundled with the .NET Framework), not Roslyn: generated snippets are therefore compiled as C# 5, which is why string interpolation ($"...") is rejected everywhere in generated code.
• Corpus search over local user-provided C# examples (paths configured locally, never shipped).

Plus a native HTTP endpoint for remote clients (claude.ai web, mobile apps, server-side agents) — Streamable HTTP (MCP spec 2025-03-26) on port 8080, X-API-Key protected, Origin-validated, no Node.js required.

Quick start

Prerequisites

• Windows 10/11
• TopSolid 7.15+ (tested on 7.20 / 7.21)
• An MCP client: Claude Code, Claude Desktop, Cursor, Windsurf, VS Code + Copilot...

Install

The easy way (v1.8.0+) — one double-click, no terminal, no Node.js:

1. Download the latest release and unzip it.
2. Double-click install\Installer_TopSolidMCP.bat — it generates the API key (DPAPI-encrypted in settings.json), creates the scheduled task that auto-starts the native server on port 8080, and cleans up any legacy v1.7 Node bridge.
3. A tray icon appears next to the clock: one process serves stdio and native HTTP. Right-click for Status / Restart / Stop / API key.

Since v1.8.0 the tray also handles:

• API key management — generate / copy / regenerate / revoke the X-API-Key of the native HTTP endpoint (stored DPAPI-encrypted in settings.json, never in clear).
• Auto-connect — reconnects to TopSolid by itself (backoff 15/30/60 s capped) if TopSolid was started after the server or gets restarted.
• What's new — opens the GitHub release notes of the installed version; the update flow now opens them automatically.
• Report a bug / Suggest a feature — prefilled GitHub issue (template, version, OS and connection state auto-injected; API key scrubbed).
• Language (v1.8.19) — the whole UI (tray menus, settings, API-key and update dialogs, installer, updater) follows the Windows display language: French on fr-* systems, English everywhere else (Dutch, German, English…), with an English fallback for anything untranslated and an Automatic / Français / English override in the tray settings. A French regional format with a non-French display language still gets English.

Then point your MCP client at http://127.0.0.1:8080/mcp (v1.8.0+: the native endpoint, X-API-Key required as soon as a key is defined). Details: install/README.md.

The native endpoint validates the Origin header per the MCP HTTP transport spec (DNS-rebinding defense): no Origin (CLI/MCP clients) and localhost/127.0.0.1/[::1] origins are allowed, any other host is rejected with HTTP 403; extra origins can be whitelisted with the TOPSOLID_MCP_ALLOWED_ORIGINS environment variable.

Manual path (developers / headless machines):

1. Enable remote access in TopSolid: Tools > Options > General > Automation → check "Manage remote access", port 8090, restart TopSolid.

2. Download the latest release (TopSolidMcpServer-vX.Y.Z.zip) and unzip to e.g. C:\TopSolidMCP\.

3. Register with your client. For Claude Code CLI:

   claude mcp add --scope user topsolid C:\TopSolidMCP\TopSolidMcpServer.exe
   

This is the beginning of the README. Read the rest at the original. Read the full README ↗