Package Exports

@stackguide/mcp-server
@stackguide/mcp-server/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@stackguide/mcp-server) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

StackGuide MCP Server

Dynamic context loading for AI coding assistants. Works with Cursor and GitHub Copilot.

Quick Start

Cursor (.cursor/mcp.json):

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

VS Code (.vscode/mcp.json): Same config as above.

Usage

Just talk naturally:

"Set up my project" → Auto-configures with interactive wizard
"Review my code" → Analyzes with Quick Fix suggestions
"Generate a component" → Creates boilerplate code
"Check project health" → Returns health score (A-F)
"Browse React rules" → Shows community rules

Tools (12 total)

Core Tools

Tool	Description	Example
`setup`	Configure project with wizard	`setup` or `setup type:"react-typescript"`
`context`	View current configuration	`context` or `context full:true`
`rules`	List, search, get rules	`rules action:"search" query:"security"`
`knowledge`	Access patterns & solutions	`knowledge action:"get" query:"architecture"`
`review`	Review code with Quick Fixes	`review file:"src/index.ts" focus:"security"`

Advanced Features (NEW in v2.4.0)

Tool	Description	Example
`generate`	Generate boilerplate code	`generate type:"component" name:"UserCard"`
`health`	Project health score (A-F)	`health detailed:true`

Integration Tools

Tool	Description	Example
`cursor`	Browse cursor.directory	`cursor action:"browse" query:"react"`
`docs`	Fetch web documentation	`docs action:"fetch" url:"https://..."`
`config`	Save/load configurations	`config action:"save" name:"my-project"`
`custom_rule`	Create custom rules	`custom_rule action:"create" name:"..." content:"..."`
`help`	Get help	`help` or `help topic:"generate"`

New in v2.4.0: Advanced Features

🏭 Template Generator

Generate boilerplate for components, hooks, services, tests, API routes, models, and utilities:

generate type:"component" name:"UserCard"
generate type:"hook" name:"useAuth"  
generate type:"service" name:"ApiService"
generate type:"test" name:"UserCard" options:{"framework":"vitest"}
generate type:"api" name:"Users" options:{"framework":"nextjs"}

🔧 Quick Fix Suggestions

Code review now includes actionable Quick Fixes:

🔴 [SEC001] Avoid using eval() - it can execute arbitrary code
- Line: 15
- Code: `eval(userInput)`
- 🔧 Quick Fix: Replace eval() with JSON.parse()
  - Replace: `eval(` → With: `JSON.parse(`

🏥 Project Health Score

Get a comprehensive health analysis with grade (A-F):

health detailed:true

Returns:

Overall score (0-100) with grade
Category breakdown (Configuration, Code Quality, Structure, Docs, Testing)
Critical issues and recommendations

🧙 Interactive Setup Wizard

Setup now provides tailored recommendations:

{
  "wizard": {
    "recommendations": {
      "suggestedTools": ["ESLint", "Prettier", "TypeScript strict mode"],
      "vsCodeExtensions": ["ES7+ React snippets", "Error Lens"],
      "tips": ["Use functional components", "Memoize with useMemo"]
    },
    "nextSteps": ["Run `context`", "Run `review`", "Run `health`"]
  }
}

Supported Stacks

python-django · python-fastapi · python-flask · react-node · react-typescript · vue-node · nextjs · express · nestjs · laravel · rails · golang · rust

Examples

# Auto-setup with wizard
setup

# Generate React component
generate type:"component" name:"Dashboard"

# Review with Quick Fixes
review file:"src/App.tsx" focus:"performance"

# Check project health
health

# Browse and import community rules
cursor action:"popular"
cursor action:"import" slug:"typescript-best-practices"

License

MIT