MCP Server for Universal Engineering Workflow - AI-Assisted Development
npm install mcp-engineering-servereval() or commits API keys without knowing. |
malloc() in your ISR. Your MCU crashes. |
--fix operations are transactional.
/eng-security --fix
├── Replace secret in config.ts ✓
├── Replace secret in utils.ts ✓
└── Replace secret in broken.ts ✗ Error!
↓
ROLLBACK: All changes reverted. Your repo is clean.
`
- Rollback: If one edit fails, all changes are reverted
- Permission Safe: Preserves chmod +x for scripts (Linux/Embedded)
- Backup Files: Creates .bak before modifications
$3
Debug 1GB+ log files instantly without eating RAM.
`bash
/eng-debug build.log --pattern "ERROR"
Uses Ring Buffer architecture
Finds exact error line in seconds
Memory usage: ~50MB regardless of file size
`
$3
Context-aware scanning that understands your stack:
| Profile | Detects |
|---------|---------|
| embedded | malloc in ISR, blocking delay(), deprecated sysfs GPIO |
| web | eval(), readFileSync, hardcoded secrets |
| dotnet | async void, Thread.Sleep in async |
$3
First-class support for Linux SBCs and MCUs.
`bash
/eng-hardware # Auto-detect Radxa, Jetson, RPi, BeagleBone
/eng-dts --conflicts # Find pin muxing conflicts BEFORE compile
/eng-dts --check "&i2c3" # Validate node reference exists
`
$3
Verify your tests actually catch bugs. No fake coverage.
`bash
/eng-mutation # Run mutation tests
/eng-mutation --mode check # Verify score >= 30% threshold
`
| Score | Verdict |
|-------|---------|
| >= 60% | Excellent |
| >= 40% | Acceptable |
| < 30% | Poor (blocks /eng-done) |
$3
Your AI learns from past work. Never solve the same problem twice.
`bash
/eng-knowledge "authentication" # Query past solutions
/eng-done --promote # Share knowledge globally
`
---
Quick Start
`bash
Install
npm install -g mcp-engineering-server
mcp-engineering-server install
In your project
/eng-init # Setup (one time)
/eng-start my-feature # Start work
... code ...
/eng-security # Check secrets
/eng-test # Fast tests
/eng-done # Complete & archive
`
---
Commands
$3
| Command | Description |
|---------|-------------|
| /eng-init | Initialize project, auto-detect type |
| /eng-start | Start feature, create context |
| /eng-plan | Create plan with knowledge injection |
| /eng-validate | Run full validation pipeline |
| /eng-review | Pre-completion checklist |
| /eng-done | Archive feature, extract knowledge |
$3
| Command | Description |
|---------|-------------|
| /eng-security | Scan secrets, API keys, credentials |
| /eng-security --fix | Auto-fix with atomic rollback |
| /eng-refactor | Find duplicates, magic numbers, long functions |
| /eng-refactor --fix | Auto-fix with .bak backups |
| /eng-deps | Detect circular imports |
$3
| Command | Description |
|---------|-------------|
| /eng-test | Fast unit tests (2-5s) |
| /eng-test --watch | TDD watch mode |
| /eng-mutation | Mutation testing (thorough) |
| /eng-pipeline | Full: build + lint + test |
$3
| Command | Description |
|---------|-------------|
| /eng-debug | Stream large logs safely |
| /eng-debug | Filter by regex |
| /eng-debug | Last N lines |
$3
| Command | Description |
|---------|-------------|
| /eng-scan | Index functions (6 languages) |
| /eng-search | Search functions, errors, patterns |
| /eng-routes | Index API routes |
| /eng-index-similar | Find similar code |
$3
| Command | Description |
|---------|-------------|
| /eng-hardware | Index MCU + SBC configs |
| /eng-dts --scan | Index device tree files |
| /eng-dts --conflicts | Detect pin conflicts |
| /eng-dts --check "&node" | Validate reference |
$3
| Command | Description |
|---------|-------------|
| /eng-checkpoint | Save session state |
| /eng-resume | Restore context |
---
Workflows
$3
`bash
/eng-test # Fast feedback (2s)
/eng-debug build.log # Find error in 1GB log
/eng-security --fix # Auto-fix secrets atomically
`
$3
`bash
/eng-init # One time setup
/eng-start user-auth # Start feature
/eng-plan user-auth # Plan with knowledge injection
... implement ...
/eng-test --watch # TDD mode
/eng-mutation # Verify test quality
/eng-review # Pre-flight checklist
/eng-done --promote # Archive + share knowledge
`
$3
`bash
/eng-hardware # Detect Jetson/Radxa/RPi
/eng-dts --scan # Index device tree
/eng-dts --conflicts # Check pin muxing
/eng-security # Uses 'embedded' profile
`
---
Supported Platforms
$3
| Category | Types |
|----------|-------|
| Web | Node.js, React, Vue, Angular |
| Backend | .NET, Python, Rust, Go |
| Embedded | STM32, ESP32, Arduino |
| Linux SBC | Radxa, Jetson, RPi, OrangePi, BeagleBone |
| Mobile | Flutter, React Native |
$3
TypeScript, Python, C#, Go, Rust, C/C++
$3
| Language | Tool |
|----------|------|
| TypeScript | Stryker |
| Python | mutmut |
| Rust | cargo-mutants |
| Go | go-mutesting |
| C# | dotnet-stryker |
---
Technical Philosophy
> No score rationalization. We report raw mutation scores.
> No fake coverage. If your tests don't catch bugs, we tell you.
> No silent failures. Atomic operations or nothing.
---
Installation
$3
`bash
npm install -g mcp-engineering-server
mcp-engineering-server install
`
$3
`bash
git clone https://github.com/liam1472/mcp-engineering-server.git
cd mcp-engineering-server
npm install && npm run build
npm link
mcp-engineering-server install
`
$3
`bash
mcp-engineering-server uninstall
npm uninstall -g mcp-engineering-server
`
---
Generated Structure
`
.engineering/
├── config.yaml # Project config
├── manifesto.md # Coding standards
├── architecture.yaml # Layer rules
├── index/
│ ├── functions.yaml # Function index
│ ├── routes.yaml # API routes
│ ├── hardware.yaml # Hardware configs
│ └── dts-index.yaml # Device tree index
├── security/
│ ├── patterns.yaml # Detection rules
│ └── whitelist.yaml # False positives
├── knowledge/
│ ├── index.yaml # Knowledge index
│ └── details/ # Detailed entries
└── features/ # Active features
``
---
Requirements
- Node.js >= 18.0.0
- Claude Code (VS Code extension or CLI)
---
License
MIT
---
Built for engineers who ship.