MCP项目初始化器
一个智能MCP(模型上下文协议)服务器,可以自动设置新的AI驱动的MCP服务器开发项目。该工具可作为任何标准MCP客户端的对话指南,为人工智能辅助开发设置具有必要背景、规则和文档的项目。
特性
- 🤖 会话项目设置 -交互式分步项目初始化
- 📋 人工智能增强PRD生成 -将基本概念转化为全面的规范
- 🔧 技术特定背景 -自动下载SDK文档和最佳实践
- 📚 开发规则集成 -包括编码标准和人工智能优化指南
- 🎯 基于上下文的开发 -为人工智能代理准备项目,以创造性的方式实施
- 🛡️ 符合MCP协议 -与MCP客户端和标准完全兼容
快速开始
安装
# Clone the repository
git clone
cd mcp-initializer
# Install dependencies
npm install
# Build the project
npm run build与MCP客户端一起使用
Windsurf IDE配置
将此服务器添加到您的Windsurf MCP设置中:
{
"mcpServers": {
"mcp-project-initializer": {
"command": "node",
"args": ["/path/to/mcp-initializer/build/index.js"],
"description": "AI-powered project initialization server"
}
}
}通用MCP客户端配置
对于支持STDIO传输的任何MCP客户端:
{
"name": "mcp-project-initializer",
"command": "node",
"args": ["/path/to/mcp-initializer/build/index.js"],
"transport": "stdio"
}用法
启动新项目
- 开始对话:使用
start_mcp_project工具 - 设置项目名称:使用
set_project_name使用您想要的项目名称 - 选择目录:使用
set_project_directory具有绝对路径 - 选择技术:使用
set_project_technology(打字或python) - 提供概念:使用
set_project_description具有高层次的概述 - 添加文档 (可选):使用
add_project_documentation获取更多上下文 - 设置基础:使用
setup_project_foundation创建项目结构 - 生成上下文:使用
generate_mcp_server为人工智能的实施做准备
对话流程示例
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!已创建项目结构
当您运行MCP项目初始化器时,它会创建:
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主要特点
AI增强开发
- 上下文丰富设置:自动下载基本的MCP文档
- 最佳实践集成:包括特定技术的编码标准
- PRD增强:AI代理将基本概念扩展为详细的规范
- 分步指导:AI代理的明确实施说明
技术支持
- TypeScript:带有ES模块的完整Node.js MCP服务器设置
- python:完成Python MCP服务器配置
- 可扩展:易于添加对其他技术的支持
MCP协议合规性
- 仅工具设计:无提示-与仅使用工具的客户端完全兼容
- 会话状态:保持工具调用之间的对话流
- 错误处理:全面的验证和用户指导
- 标准运输:使用STDIO实现最大兼容性
发展
从源头构建
# 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项目结构
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需求
- Node.js: >= 18.0.0
- MCP客户端:任何兼容MCP的客户端(Windsurf、Claude Desktop等)
- 操作系统:macOS、Linux、Windows
贡献
- 分叉存储库
- 创建要素分支
- 按照编码标准进行更改
- 使用真实的MCP客户端进行测试
- 提交拉取请求
许可证
MIT许可证-有关详细信息,请参阅许可证文件。
支持
对于问题和疑问:
- 查看中的文档
/docs - 查看生成的
IMPLEMENTATION.md用于指导 - 在项目存储库上打开一个问题
______________________________________________________________________
准备好创建AI驱动的项目了吗? 在您的客户端中配置此MCP服务器并开始构建! 🚀
