StackGuide MCP Server

Dynamic context + active engineering workflow for AI coding assistants in Cursor, VS Code, and other MCP clients.

What It Does

@stackguide/mcp-server helps teams standardize implementation quality with:

• project-aware rule/context loading
• code review and health scoring
• auto-detected setup and stack scaffolding
• active agent workflow that executes real work (intake, plan, verify, release)
• tracker + VCS + test orchestration for delivery flow

This server is built for real team usage, not just prompt templates.

What's New In v4.x

• Added active agent tool (execution-first workflow).
• init now generates .stackguide/config.json automatically.
• Added tracker service support for GitHub, GitLab, and Jira.
• Added VCS service for branch checks, commit parsing, CI status, and PR/MR creation.
• Added test runner service for structured test/lint/build execution.
• Updated TDD prompts to use active tool calls instead of large passive markdown payloads.
• Hardened local persistence:
  • .stackguide artifacts removed from version control
  • repository guard blocks accidental tracking of local artifacts
  • cache and health history include integrity validation and safer writes

Install

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "stackguide": {
      "command": "npx",
      "args": ["-y", "@stackguide/mcp-server"]
    }
  }
}

VS Code (.vscode/mcp.json)

Use the same config as Cursor.

Quick Start

1. Configure your project:

init action:"full"

1. Check generated setup:

init action:"status"
agent action:"status"

1. Run active TDD workflow:

agent action:"intake" ticket:"PROJ-123"
agent action:"plan" brief:"<brief-from-intake>"
agent action:"verify"
agent action:"release" version:"v1.2.0"

Tools (16)

Core

• setup: configure StackGuide context for project type
• context: show currently loaded context
• rules: list/search/get/select rule sets
• knowledge: list/search/get knowledge files
• review: analyze files/URLs/project code quality

Utility

• cursor: browse/import community rules
• docs: fetch/search/list documentation
• config: save/load/export/import configurations
• custom_rule: create/update/delete/list project custom rules
• help: usage help by topic

Advanced

• generate: boilerplate generation (component/hook/service/test/api/model/util)
• health: project health score and recommendations
• analyze: project intelligence (structure/config/dependency/generate/apply)

Workflow

• workflow: lazy-load raw workflow assets (agents/skills/hooks/commands)
• init: scaffold .stackguide with stack-aware defaults
• agent: active workflow executor (status, intake, plan, verify, release)

Active Workflow Details

agent action:"intake"

• reads ticket from configured tracker
• returns normalized brief + gaps
• proposes branch name convention

agent action:"plan"

• inspects conventions + project shape
• creates vertical-slice plan
• returns exactly 3 target tests in structured format

agent action:"verify"

• executes configured tests/lint/build per layer
• checks branch naming + commit convention + TDD test budget
• returns blocker list and final pass/fail report

agent action:"release"

• checks CI status
• parses commits since last tag
• suggests semver impact (major / minor / patch)
• can create tag and PR/MR (when enabled)

Local Data And Security

init generates:

• .stackguide/config.json (project workflow config)

Runtime/local arti

... View full README on GitHub