MCP Engineering Server

![npm version](https://www.npmjs.com/package/mcp-engineering-server)
![npm downloads](https://www.npmjs.com/package/mcp-engineering-server)
![License](LICENSE)
![Node](https://nodejs.org)
![Platform](https://github.com/phdlam/mcp-engineering-server)

> The "Engineering OS" for AI Agents.
> Turn your LLM into a Senior Engineer capable of handling 1GB+ logs, atomic refactoring, and embedded systems safely.

---

Why This Exists

Most AI coding tools fail at scale:

| Problem | What Happens |
|---------|--------------|
| OOM Crashes | Ask Claude to analyze a 500MB build log. It dies. |
| Broken Builds | AI edits 5 files, fails on the 6th, leaving your repo corrupted. |
| Blind Security | AI writes eval() or commits API keys without knowing. |
| No Hardware Awareness | AI suggests malloc() in your ISR. Your MCU crashes. |

MCP Engineering Server fixes this. It provides the "Hands and Eyes" for Claude to work safely on massive, complex repositories.

---

Superpowers

$3

Never break your build again. All --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 --pattern "ERROR"

 | Filter by regex |

|

/eng-debug --tail 500

 | 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.

`MCP Engineering Server`





![npm version](https://www.npmjs.com/package/mcp-engineering-server)

![npm downloads](https://www.npmjs.com/package/mcp-engineering-server)

![License](LICENSE)

![Node](https://nodejs.org)

![Platform](https://github.com/phdlam/mcp-engineering-server)



> The "Engineering OS" for AI Agents.

> Turn your LLM into a Senior Engineer capable of handling 1GB+ logs, atomic refactoring, and embedded systems safely.



---



Why This Exists



Most AI coding tools fail at scale:



| Problem | What Happens |

|---------|--------------|

| OOM Crashes | Ask Claude to analyze a 500MB build log. It dies. |

| Broken Builds | AI edits 5 files, fails on the 6th, leaving your repo corrupted. |

| Blind Security | AI writes eval() or commits API keys without knowing. |

| No Hardware Awareness | AI suggests malloc() in your ISR. Your MCU crashes. |



MCP Engineering Server fixes this. It provides the "Hands and Eyes" for Claude to work safely on massive, complex repositories.



---



Superpowers



$3



Never break your build again. All --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  --pattern "ERROR" | Filter by regex |

| /eng-debug  --tail 500 | 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.