MCP server for building project structures with various frameworks
npm install builder-proj-mcp一个强大的模型上下文协议(MCP)服务器,用于构建各种框架的项目结构。此工具可帮助您快速搭建 Spring Boot、React、Vue、Next.js、Nuxt.js、FastAPI、Django、Flask、Express、Fastify、NestJS 等框架的项目。
- 多框架支持: 支持多种技术栈的项目构建
- TypeScript 支持: 完整的 TypeScript 实现
- 灵活配置: 自定义项目选项
- MCP 协议: 与 MCP 兼容的客户端无缝集成
spring-boot - Spring Boot + Mavenspring - 通用 Spring 框架spring-mvc - Spring MVCspring-webflux - Spring WebFluxreact - React + Vitereact-vite - React + Vitereact-cra - React + Create React Appvue - Vue 3 + Vitevue3 - Vue 3vue-vite - Vue + Vitevite - 纯 Vitevite-vanilla - 纯 Vitevite-ts - Vite + TypeScriptnext - Next.js + App Routernextjs - Next.jsnext-app - Next.js App Routernext-pages - Next.js Pages Routernuxt - Nuxt.js 3nuxt3 - Nuxt.js 3fastapi - FastAPI + Uvicornfastapi-uvicorn - FastAPI + Uvicornfastapi-gunicorn - FastAPI + Gunicorndjango - Djangodjango-rest - Django REST Frameworkdjango-cms - Django CMSflask - Flaskflask-rest - Flask REST APIflask-sqlalchemy - Flask + SQLAlchemyexpress - Express.jsfastify - Fastifynestjs - NestJS使用 npx 是最简单的方式,它会自动下载并运行包:
``bash`直接使用 npx 运行
npx builder-proj-mcp
`bash克隆仓库
git clone
cd builder-proj-mcp
$3
您也可以全局安装以便在任何地方使用:
`bash
全局安装
npm install -g builder-proj-mcp运行服务器
builder-proj-mcp
`使用方法
$3
添加到您的 MCP 客户端配置中:
使用 npx(推荐):
`json
{
"mcpServers": {
"builder-proj": {
"command": "npx",
"args": ["builder-proj-mcp"]
}
}
}
`使用本地安装:
`json
{
"mcpServers": {
"builder-proj": {
"command": "node",
"args": ["path/to/builder-proj-mcp/dist/index.js"]
}
}
}
`$3
#### 1. build_project
使用指定框架构建新项目。
参数说明:
-
projectName (string, 必填): 要创建的项目名称
- projectType (string, 可选): 项目类型 (web, api, mobile, desktop)
- framework (string, 必填): 使用的框架
- options (object, 可选): 额外配置选项示例:
`typescript
// 创建 React 项目
{
"projectName": "my-react-app",
"framework": "react",
"options": {
"typescript": true,
"tailwind": true,
"stateManagement": "zustand",
"router": true
}
}// 创建 Vue 项目
{
"projectName": "my-vue-app",
"framework": "vue",
"options": {
"typescript": true,
"tailwind": true,
"stateManagement": "pinia",
"router": true
}
}
// 创建 Spring Boot 项目
{
"projectName": "my-spring-app",
"framework": "spring-boot",
"options": {
"javaVersion": "17",
"springBootVersion": "3.2.0",
"groupId": "com.example"
}
}
// 创建 FastAPI 项目
{
"projectName": "my-api",
"framework": "fastapi",
"options": {
"pythonVersion": "3.11",
"docker": true,
"tests": true
}
}
`#### 2. list_frameworks
列出所有支持的项目框架。
示例:
`typescript
{
"name": "list_frameworks"
}
`框架特定选项
$3
- typescript: 使用 TypeScript(默认: true)
- tailwind: 使用 Tailwind CSS(默认: false)
- stateManagement: 状态管理库(默认: none)
- zustand - React 状态管理
- pinia - Vue 状态管理
- redux - React 状态管理
- router: 包含路由配置(默认: false)
- eslint: 包含 ESLint 配置(默认: false)
- prettier: 包含 Prettier 配置(默认: false)
- testing: 包含测试配置(默认: true)$3
- javaVersion: Java 版本(默认: "17")
- springBootVersion: Spring Boot 版本(默认: "3.2.0")
- groupId: Maven groupId(默认: "com.example")
- artifactId: Maven artifactId(默认: 项目名称)
- docker: 包含 Docker 配置(默认: true)
- tests: 包含测试配置(默认: true)$3
- pythonVersion: Python 版本(默认: "3.11")
- docker: 包含 Docker 配置(默认: true)
- tests: 包含测试配置(默认: true)
- database: 数据库类型(如 postgresql, mysql, mongodb)项目结构
`
builder-proj-mcp/
├── src/
│ ├── builders/
│ │ ├── spring-boot-builder.ts
│ │ ├── react-builder.ts
│ │ ├── vue-builder.ts
│ │ ├── fastapi-builder.ts
│ │ ├── django-builder.ts
│ │ ├── flask-builder.ts
│ │ ├── vite-builder.ts
│ │ └── index.ts
│ ├── types.ts
│ └── index.ts
├── package.json
├── tsconfig.json
└── README.md
`开发
`bash
开发模式运行
npm run dev构建生产版本
npm run build启动服务器
npm start
``项目采用构建者模式,包含以下组件:
- ProjectBuilder 接口: 定义所有构建者的契约
- BuilderFactory: 管理和提供对所有构建者的访问
- 框架构建者: 每个框架的独立实现
- MCP 服务器: 处理工具注册和请求处理
欢迎贡献!请随时提交 Pull Request。
MIT
如有问题和疑问,请在该仓库中开启 issue。
---