MCP Project Initializer
An intelligent MCP (Model Context Protocol) server that automates the setup of new AI-powered MCP server development projects. This tool acts as a conversational guide through any standard MCP client to set up projects with necessary context, rules, and documentation for AI-assisted development.
Features
- 🤖 Conversational Project Setup - Interactive step-by-step project initialization
- 📋 AI-Enhanced PRD Generation - Transform basic concepts into comprehensive specifications
- 🔧 Technology-Specific Context - Automatically downloads SDK documentation and best practices
- 📚 Development Rules Integration - Includes coding standards and AI-optimized guidelines
- 🎯 Context-Based Development - Prepares projects for AI agents to implement with creativity
- 🛡️ MCP Protocol Compliant - Full compatibility with MCP clients and standards
Quick Start
Installation
# Clone the repository
git clone <repository-url>
cd mcp-initializer
# Install dependencies
npm install
# Build the project
npm run build
Using with MCP Clients
Windsurf IDE Configuration
Add this server to your Windsurf MCP settings:
{
"mcpServers": {
"mcp-project-initializer": {
"command": "node",
"args": ["/path/to/mcp-initializer/build/index.js"],
"description": "AI-powered project initialization server"
}
}
}
Generic MCP Client Configuration
For any MCP client that supports STDIO transport:
{
"name": "mcp-project-initializer",
"command": "node",
"args": ["/path/to/mcp-initializer/build/index.js"],
"transport": "stdio"
}
Usage
Starting a New Project
- Start the conversation: Use the
start_mcp_projecttool - Set project name: Use
set_project_namewith your desired project name - Choose directory: Use
set_project_directorywith an absolute path - Select technology: Use
set_project_technology(typescript or python) - Provide concept: Use
set_project_descriptionwith a high-level overview - Add documentation (optional): Use
add_project_documentationfor additional context - Setup foundation: Use
setup_project_foundationto create the project structure - Generate context: Use
generate_mcp_serverto prepare for AI implementation
Example Conversation Flow
User: Use start_mcp_project
AI: 🚀 Welcome! I'll help you create a new MCP Server project...
User: Use set_project_name with "task-manager-mcp"
AI: ✅ Great! Project name set to: task-manager-mcp...
User: Use set_project_directory with "/Users/yourname/Projects"
AI: ✅ Perfect! Project directory set...
User: Use set_project_technology with "typescript"
AI: ✅ Excellent! Technology set to: typescript...
User: Use set_project_description with "Help users manage daily tasks with reminders"
AI: ✅ Perfect! Description captured...
User: Use setup_project_foundation
AI: 🚀 Setting up project foundation... ✓ Downloaded essential MCP documentation...
User: Use generate_mcp_server
AI: 🎉 Your Project is Ready for AI Implementation!
Project Structure Created
When you run the MCP Project Initializer, it creates:
your-project/
├── README.md # Project overview
├── CLAUDE.md # AI development guidance
├── IMPLEMENTATION.md # Detailed implementation guide
├── PRD.md # Product Requirements Document
├── package.json # Dependencies and scripts
├── tsconfig.json # TypeScript configuration
├── .gitignore # Git ignore rules
├── .windsurf/
│ └── rules/ # Development best practices
│ ├── general.md # General coding standards
│ ├── typescript.md # TypeScript-specific rules
│ └── mcp.md # MCP development patterns
├── docs/
│ └── external/ # Downloaded documentation
│ ├── llms-full.txt # MCP client compatibility
│ └── typescript-sdk-README.md # SDK documentation
├── src/ # Source code directory
└── tests/ # Test directory
Key Features
AI-Enhanced Development
- Context-Rich Setup: Downloads essential MCP documentation automatically
- Best Practices Integration: Includes technology-specific coding standards
- PRD Enhancement: AI agents expand basic concepts into detailed specifications
- Step-by-Step Guidance: Clear implementation instructions for AI agents
Technology Support
- TypeScript: Full Node.js MCP server setup with ES modules
- Python: Complete Python MCP server configuration
- Extensible: Easy to add support for additional technologies
MCP Protocol Compliance
- Tools-Only Design: No prompts - fully compatible with tools-only clients
- Conversational State: Maintains conversation flow across tool calls
- Error Handling: Comprehensive validation and user guidance
- Standard Transport: Uses STDIO for maximum compatibility
Development
Building from Source
# Install dependencies
npm install
# Build the project
npm run build
# Run in development mode
npm run dev
# Type checking
npm run typecheck
# Linting
npm run lint
Project Structure
mcp-initializer/
├── src/
│ ├── index.ts # MCP server main entry
│ ├── project-initializer.ts # Core initialization logic
│ └── types.ts # TypeScript type definitions
├── templates/
│ └── rules/ # Development rule templates
│ ├── typescript.md # TypeScript best practices
│ └── python.md # Python best practices
├── build/ # Compiled output
└── docs/ # Project documentation
Requirements
- Node.js: >= 18.0.0
- MCP Client: Any MCP-compatible client (Windsurf, Claude Desktop, etc.)
- Operating System: macOS, Linux, Windows
Contributing
- Fork the repository
- Create a feature branch
- Make your changes following the coding standards
- Test with a real MCP client
- Submit a pull request
License
MIT License - see LICENSE file for details.
Support
For issues and questions:
- Check the documentation in
/docs - Review the generated
IMPLEMENTATION.mdfor guidance - Open an issue on the project repository
Ready to create AI-powered projects? Configure this MCP server in your client and start building! 🚀