Skip to content
Back to search

vw-mcp

MCP server for Vectorworks: lets AI assistants script Vectorworks safely

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 17 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/stevenmorgan94/vw-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/stevenmorgan94/vw-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/stevenmorgan94--vw-mcp/badge.svg)](/listings/stevenmorgan94--vw-mcp)

HTML

<a href="/listings/stevenmorgan94--vw-mcp"><img src="/api/listings/stevenmorgan94--vw-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 51 lines
  1. # vw-mcp
  2. MCP server for Vectorworks: lets AI assistants script Vectorworks safely.
  3. > **Status: work in progress.** This repo is a scaffold. The safety layer, sweep harness and relay are here; the
  4. > headless plug-in builds but does nothing yet beyond logging at launch. Not usable end to end. First target:
  5. > macOS, Vectorworks 2027.
  6. ## Architecture
  7. 1. **Plug-in** (`plugin/`): a headless `vw-mcp.vwlibrary`. An `IObjUpdateSupport` provider starts at Vectorworks launch.
  8. 2. **Bridge** (in the plug-in, [#6](https://github.com/stevenmorgan94/vw-mcp/issues/6)): a local HTTP server on `127.0.0.1` queues jobs and runs them on the main thread.
  9. 3. **Relay** (`relay/`): a Node MCP server (`npx -y vw-mcp`) that MCP clients talk to; it forwards jobs to the plug-in.
  10. 4. **Safety** (`safety/`): every `vs.*` call is checked in the engine against a class table built by testing each function.
  11. 5. **Sweep** (`sweep/`): the harness that builds that table by running every function against a throwaway document.
  12. ## Layout
  13. | Path | What |
  14. |---|---|
  15. | `plugin/` | Xcode project (`VW_YEAR`, default 2027), sources in `src/{bridge,nativeops,safety}` |
  16. | `relay/` | The MCP server (Node) |
  17. | `safety/` | `vwguard.py` (in-engine guard), `build_table.py`, `vs-safety-table.json`, `functions.csv` |
  18. | `sweep/` | The sweep harness and derive step |
  19. | `docs/` | [Hardening spec](docs/MCP_HARDENING_SPEC.md), [glossary](docs/GLOSSARY.md), [sweep results](docs/sweep/README.md) |
  20. | `tools/` | Build and deploy scripts, ISDK dispatch generator (stub) |
  21. ## Building the plug-in (macOS)
  22. Needs Xcode and the Vectorworks SDK for the target year (from Vectorworks' developer program; not included).
  23. ```sh
  24. VW_SDK_DIR=/path/to/VectorworksSDK/SDK2027 tools/build-plugin.sh 2027 Debug # -> build/2027/Debug/vw-mcp.vwlibrary
  25. tools/deploy-plugin.sh 2027 Debug # copies it into the VW 2027 Plug-ins folder
  26. ```
  27. `VW_SDK_DIR` defaults to `../VectorworksSDK/SDK<year>` next to this checkout. For builds from the Xcode app, copy
  28. `plugin/Config/Local.xcconfig.example` to `plugin/Config/Local.xcconfig` and set it there.
  29. Rebuild the safety table and its generated C++ include after a sweep: `python3 safety/build_table.py`.
  30. ## Trademark
  31. Vectorworks is a trademark of Vectorworks, Inc. This project is not affiliated with, endorsed by or sponsored by
  32. Vectorworks, Inc.
  33. ## Licence
  34. MIT. See [LICENSE](LICENSE). The Vectorworks SDK is licensed separately by Vectorworks, Inc. and is not part of this repo.
  35. Provenance: split out of the bridge in the author's SolotechSuite plug-in.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.