System Overview
User Layer
Mechanical Engineer
Asks CAD questions in their AI tool
AI Tool Layer
Claude Code
SOLIDWORKS macros
Cursor
CAD scripting
Copilot
Engineering code
MCP Protocol (stdio)
SolidContext Layer
SolidContext MCP Server
resolve-software query-docs
Built-in search • No external deps • Runs locally via npx
reads at startup
Content Layer
Doc Bundle
Pre-generated markdown docs
bundled with npm package
generated from
Source Layer (separate pipeline)
SolidProfessor Content
Course transcripts • Lesson scripts
Expert procedural knowledge
Content Pipeline
1
Course Data
Lessons, transcripts, metadata
→
2
Doc Generator
Transforms to structured docs
→
3
Markdown Docs
Frontmatter + content per topic
→
4
npm Publish
Bundled with MCP server
→
5
Served via MCP
AI tools query at runtime
Key Decisions
| Decision | Choice | Rationale |
|---|---|---|
| Distribution | npm package | Same as context7 — npx one-liner setup, works in any MCP client |
| Content source | Pre-generated docs | Generated from course data separately, bundled with the package |
| Search | Built-in, no external deps | Bounded dataset — lightweight text search is sufficient |
| Auth model | Optional API key env var | No key = public tier. SOLIDCONTEXT_API_KEY = premium tier |
| Tool count | 2 tools | Matches context7's proven simplicity: resolve + query |
Project Structure
solidcontext-mcp/ ├── package.json # @solidprofessorhub/solidcontext-mcp ├── src/ │ ├── index.ts # Entry point, stdio transport │ ├── server.ts # MCP server + tool registration │ ├── tools/ │ │ ├── resolve-software.ts # Fuzzy-match software names │ │ └── query-docs.ts # Search + retrieve docs │ ├── data/ │ │ ├── loader.ts # Read & index doc files │ │ └── types.ts # Software, Doc interfaces │ └── search/ │ └── simple-search.ts # Lightweight text search └── docs/ # Pre-generated content ├── solidworks/ │ ├── meta.json │ ├── swept-boss.md │ └── assembly-mates.md ├── autocad/ ├── revit/ └── catia/Tech Stack
@modelcontextprotocol/sdk
Official MCP TypeScript SDK — stdio + HTTP transport
TypeScript
Type-safe server implementation
Markdown + Frontmatter
Human-readable, easy to parse doc format
Built-in Search
Lightweight TF-IDF — zero external dependencies
npm / npx
One-liner install, just like context7
Vitest
Fast unit testing framework