{"id":35886815,"url":"https://github.com/fhyxz1/builder-proj-mcp","last_synced_at":"2026-01-08T21:02:55.777Z","repository":{"id":331348303,"uuid":"1126279323","full_name":"fhyxz1/builder-proj-mcp","owner":"fhyxz1","description":"一个专为vibe coding构建的 MCP Server，用于开发时自动搭建、初始化各种全栈/前端/后端工程结构。","archived":false,"fork":false,"pushed_at":"2026-01-02T06:12:05.000Z","size":61,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-06T18:59:25.070Z","etag":null,"topics":["django","fastapi","fastify","mcp-server","nodejs","spring"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fhyxz1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-01T15:03:38.000Z","updated_at":"2026-01-02T06:12:09.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/fhyxz1/builder-proj-mcp","commit_stats":null,"previous_names":["fhyxz1/builder-proj-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/fhyxz1/builder-proj-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fhyxz1%2Fbuilder-proj-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fhyxz1%2Fbuilder-proj-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fhyxz1%2Fbuilder-proj-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fhyxz1%2Fbuilder-proj-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fhyxz1","download_url":"https://codeload.github.com/fhyxz1/builder-proj-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fhyxz1%2Fbuilder-proj-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28248937,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2026-01-08T02:00:06.591Z","response_time":241,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["django","fastapi","fastify","mcp-server","nodejs","spring"],"created_at":"2026-01-08T21:01:35.876Z","updated_at":"2026-01-08T21:02:55.772Z","avatar_url":"https://github.com/fhyxz1.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Builder-Proj-MCP Server\n\nA powerful Model Context Protocol (MCP) server for building project structures with various frameworks. This tool helps you quickly scaffold projects for Spring Boot, React, Vue, Next.js, Nuxt.js, FastAPI, Django, Flask, Express, Fastify, NestJS, and more.\n\n**Language**: [English](README.md) | [中文](README.zh-CN.md)\n\n## Why Build This?\nDuring daily vibe coding, building projects with different tech stacks often requires using different tools and command combinations, which can lead to unnecessary token overhead. Builder Project MCP Server provides a unified interface that allows you to quickly scaffold project structures by invoking a series of tools, thereby improving development efficiency.\n\n## Features\n\n- **Multiple Framework Support**: Build projects for various tech stacks\n- **TypeScript Support**: Full TypeScript implementation\n- **Flexible Configuration**: Customize project options\n- **MCP Protocol**: Integrates seamlessly with MCP-compatible clients\n\n## Supported Frameworks\n\n### Spring/Java\n- `spring-boot` - Spring Boot with Maven\n- `spring` - Generic Spring framework\n- `spring-mvc` - Spring MVC\n- `spring-webflux` - Spring WebFlux\n\n### Frontend (Vite-based)\n- `react` - React with Vite\n- `react-vite` - React with Vite\n- `react-cra` - React with Create React App\n- `vue` - Vue 3 with Vite\n- `vue3` - Vue 3\n- `vue-vite` - Vue with Vite\n- `vite` - Vanilla Vite\n- `vite-vanilla` - Vanilla Vite\n- `vite-ts` - Vite with TypeScript\n\n### Next.js (React SSR/SSG)\n- `next` - Next.js with App Router\n- `nextjs` - Next.js\n- `next-app` - Next.js App Router\n- `next-pages` - Next.js Pages Router\n\n### Nuxt.js (Vue SSR/SSG)\n- `nuxt` - Nuxt.js 3\n- `nuxt3` - Nuxt.js 3\n\n### Python\n- `fastapi` - FastAPI with Uvicorn\n- `fastapi-uvicorn` - FastAPI with Uvicorn\n- `fastapi-gunicorn` - FastAPI with Gunicorn\n- `django` - Django\n- `django-rest` - Django REST Framework\n- `django-cms` - Django CMS\n- `flask` - Flask\n- `flask-rest` - Flask REST API\n- `flask-sqlalchemy` - Flask with SQLAlchemy\n\n### JavaScript/TypeScript Backend\n- `express` - Express.js\n- `fastify` - Fastify\n- `nestjs` - NestJS\n\n## Installation\n\n### Using npx (Recommended)\n\nThe easiest way to use Builder Project MCP Server is via npx, which downloads and runs the package automatically:\n\n```bash\n# Run directly with npx\nnpx builder-proj-mcp\n```\n\n### From Source\n\n```bash\n# Clone the repository\ngit clone \u003crepository-url\u003e\ncd builder-proj-mcp\n\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n```\n\n### Global Installation\n\nYou can also install it globally to use it from anywhere:\n\n```bash\n# Install globally\nnpm install -g builder-proj-mcp\n\n# Run the server\nbuilder-proj-mcp\n```\n\n## Usage\n\n### As MCP Server\n\nAdd to your MCP client configuration:\n\n**Using npx (Recommended):**\n```json\n{\n  \"mcpServers\": {\n    \"builder-proj\": {\n      \"command\": \"npx\",\n      \"args\": [\"builder-proj-mcp\"]\n    }\n  }\n}\n```\n\n**Using local installation:**\n```json\n{\n  \"mcpServers\": {\n    \"builder-proj\": {\n      \"command\": \"node\",\n      \"args\": [\"path/to/builder-proj-mcp/dist/index.js\"]\n    }\n  }\n}\n```\n\n### Available Tools\n\n#### 1. build_project\n\nBuild a new project with specified framework.\n\n**Parameters:**\n- `projectName` (string, required): Name of the project to create\n- `projectType` (string, optional): Type of project (web, api, mobile, desktop)\n- `framework` (string, required): Framework to use\n- `options` (object, optional): Additional configuration options\n\n**Example:**\n\n```typescript\n// Create a React project\n{\n  \"projectName\": \"my-react-app\",\n  \"framework\": \"react\",\n  \"options\": {\n    \"typescript\": true\n  }\n}\n\n// Create a Spring Boot project\n{\n  \"projectName\": \"my-spring-app\",\n  \"framework\": \"spring-boot\",\n  \"options\": {\n    \"javaVersion\": \"17\",\n    \"springBootVersion\": \"3.2.0\",\n    \"groupId\": \"com.example\"\n  }\n}\n\n// Create a FastAPI project\n{\n  \"projectName\": \"my-api\",\n  \"framework\": \"fastapi\",\n  \"options\": {\n    \"pythonVersion\": \"3.11\",\n    \"docker\": true,\n    \"tests\": true\n  }\n}\n```\n\n#### 2. list_frameworks\n\nList all supported frameworks for project creation.\n\n**Example:**\n```typescript\n{\n  \"name\": \"list_frameworks\"\n}\n```\n\n## Framework-Specific Options\n\n### Spring Boot\n- `javaVersion`: Java version (default: \"17\")\n- `springBootVersion`: Spring Boot version (default: \"3.2.0\")\n- `groupId`: Maven groupId (default: \"com.example\")\n- `artifactId`: Maven artifactId (default: projectName)\n\n### React/Vue/Vite\n- `typescript`: Use TypeScript (default: true)\n\n### Python (FastAPI/Django/Flask)\n- `pythonVersion`: Python version (default: \"3.11\")\n- `docker`: Include Docker configuration (default: true)\n- `tests`: Include test setup (default: true)\n\n## Project Structure\n\n```\nbuilder-proj-mcp/\n├── src/\n│   ├── builders/\n│   │   ├── spring-boot-builder.ts\n│   │   ├── react-builder.ts\n│   │   ├── vue-builder.ts\n│   │   ├── fastapi-builder.ts\n│   │   ├── django-builder.ts\n│   │   ├── flask-builder.ts\n│   │   ├── vite-builder.ts\n│   │   └── index.ts\n│   ├── types.ts\n│   └── index.ts\n├── package.json\n├── tsconfig.json\n└── README.md\n```\n\n## Development\n\n```bash\n# Run in development mode\nnpm run dev\n\n# Build for production\nnpm run build\n\n# Start the server\nnpm start\n```\n\n## Architecture\n\nThe project follows a builder pattern with the following components:\n\n- **ProjectBuilder Interface**: Defines the contract for all builders\n- **BuilderFactory**: Manages and provides access to all builders\n- **Framework Builders**: Individual implementations for each framework\n- **MCP Server**: Handles tool registration and request processing\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nMIT\n\n## Support\n\nFor issues and questions, please open an issue on the repository.\n\n---\n\n**Language**: [English](README.md) | [中文](README.zh-CN.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffhyxz1%2Fbuilder-proj-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffhyxz1%2Fbuilder-proj-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffhyxz1%2Fbuilder-proj-mcp/lists"}