ASD MCP - Lightweight project orchestration for Claude Code & Cursor
npm install asd-mcpSolve the "context preparation tax" problem when using AI development tools.
Instead of spending 5-10 minutes explaining project context every session, ASD MCP maintains project state and generates perfect handoff context in 30 seconds.
When using Claude Code or Cursor, every new session starts the same way:
- "I'm working on X feature..."
- "Here's what I've built so far..."
- "My current task is..."
Result: 5-10 minutes of context preparation per session, destroying AI productivity gains.
ASD MCP is a lightweight orchestrator that provides structured workflows and maintains project state, letting AI tools focus on what they do best: implementation.
Core Innovation: Don't replace AI capabilities - give AI tools the context they need to excel.
ASD MCP v0.1.0 is now in beta! We're looking for developers to test the core workflows and provide feedback.
๐ Join the Beta Test Program
bash
Install from NPM (Production Release)
npm install -g asd-mcpOr install for development
git clone https://github.com/tylerbarnard/asd-mcp.git
cd asd-mcpInstall dependencies
npm installBuild the project
npm run build
`$3
Add to your Claude Code/Cursor MCP configuration:
`json
{
"mcpServers": {
"asd-mcp": {
"command": "node",
"args": ["/path/to/asd-mcp/build/index.js"],
"env": {}
}
}
}
`$3
In Claude Code, say:
`
"Let's create a PRD for a user authentication system"
`The MCP will guide you through a structured interview to create your project.
๐ Core Workflows
$3
`bash
Single command project setup
"Initialize a new feature project for user authentication"
`What it creates:
- Complete project structure
- PRD, design specs, and task breakdown
- Approval checkpoints
- Implementation workflow
$3
`bash
Get project status
"Show me the current project status"Continue implementation
"Keep going on the project"Update progress
"Mark the OAuth integration task as complete"
`$3
`bash
Create feature PRD
"Create a feature PRD for password reset functionality"Feature automatically added to main PRD
Continue with implementation workflow
`๐ ๏ธ MCP Tools
$3
- asd_initialize_project - Complete project setup
- asd_create_prd - Interactive PRD creation
- asd_create_discovery - Design and technical specs
- asd_create_tasks - Comprehensive task breakdown
- asd_keep_going - Implementation workflow$3
- asd_approve_prd - Approve PRD and advance to discovery
- asd_approve_discovery - Approve specs and advance to tasks
- asd_approve_tasks - Approve tasks and start implementation
- asd_check_approval - Check current approval status$3
- asd_create_feature_prd - Create feature-specific PRDs
- asd_update_progress - Update task completion status
- asd_milestone_reached - Document milestone completion$3
- asd_get_status - Enhanced progress display
- asd_get_template - Access project templates
- asd_generate_handoff - Create context for AI tools๐ Project Structure
`
your-project/
โโโ .asd/ # ASD MCP state and data
โ โโโ state.json # Project state and approvals
โ โโโ templates/ # Project templates
โ โโโ milestones/ # Progress documentation
โโโ docs/ # Project documentation
โ โโโ PRD_Main.md # Main product requirements
โ โโโ Design_Spec.md # Design specifications
โ โโโ Technical_Spec.md # Technical specifications
โ โโโ Tasks.md # Task breakdown and progress
โ โโโ features/ # Feature-specific PRDs
โโโ src/ # Your project source code
`๐ฏ Success Metrics
$3
- Context prep: 10 minutes โ 30 seconds (95% reduction)
- Session startup: Instant AI context
- Project onboarding: 2 minutes for any project$3
- Context accuracy: Perfect every time
- Zero context loss between sessions
- Clear next steps always available๐ง Development
$3
- Node.js 18+
- TypeScript 5+
- Jest for testing$3
`bash
Install dependencies
npm installBuild the project
npm run buildRun tests
npm testRun tests with coverage
npm run test:coverage
`$3
`
src/
โโโ core/ # Core functionality
โ โโโ state-manager.ts # State management
โ โโโ template-engine.ts # Template processing
โ โโโ markdown-parser.ts # PRD parsing
โโโ tools/ # MCP tool implementations
โ โโโ prd-creation.ts # PRD creation workflow
โ โโโ discovery-phase.ts # Design and technical specs
โ โโโ task-breakdown.ts # Task generation
โ โโโ ... # Other tools
โโโ types/ # TypeScript interfaces
โโโ utils/ # Utility functions
โโโ index.ts # MCP server entry point
`$3
`bash
Run all tests
npm testRun specific test file
npm test -- src/core/state-manager.test.tsRun tests with coverage
npm run test:coverageRun tests in watch mode
npm run test:watch
`๐ Documentation
- User Guide - Comprehensive usage guide
- Troubleshooting - Common issues and solutions
- PRD - Product requirements document
- Design - Technical architecture
- Tasks - Implementation task breakdown
๐ค Contributing
1. Fork the repository
2. Create a feature branch (
git checkout -b feature/amazing-feature)
3. Make your changes
4. Add tests for new functionality
5. Run the test suite (npm test)
6. Commit your changes (git commit -m 'Add amazing feature')
7. Push to the branch (git push origin feature/amazing-feature`)This project is licensed under the MIT License - see the LICENSE file for details.
- Built for Claude Code and Cursor users
- Inspired by the need to eliminate context preparation overhead
- Designed to enhance AI development tool effectiveness
---
Stop building AI capabilities. Start orchestrating AI tools effectively.
ASD MCP recognizes that:
- AI tools excel at implementation when properly contextualized
- Developers waste enormous time on manual context preparation
- Simple state tracking solves 90% of AI collaboration problems
- Orchestration beats duplication
Result: You focus on decisions. AI handles implementation. Nothing gets lost.