MCP Spring Boot Toolkit

MCP (Model Context Protocol) server cung cấp tools, resources và prompts hỗ trợ phát triển dự án Java Spring Boot.

Tính năng

Tools (8 tools)

Tool	Mô tả
generate_entity	Tạo JPA Entity class với Lombok annotations, audit fields (createdAt/updatedAt), soft delete
generate_controller	Tạo REST Controller với CRUD endpoints, pagination, validation
generate_service	Tạo Service interface + implementation với @Transactional, @Cacheable
generate_dto	Tạo Request/Response DTOs với validation annotations + MapStruct mapper
generate_repository	Tạo Spring Data JPA Repository với custom query methods, Specification support
generate_exception_handler	Tạo @ControllerAdvice global exception handler + custom exception classes
generate_application_properties	Tạo application.yml theo profile (dev/prod) với database, security, actuator, swagger...
analyze_pom	Phân tích pom.xml để tìm vấn đề dependency, version conflict và đề xuất cải thiện

Prompts (6 prompts)

Prompt	Mô tả
review_api	Review REST API controller theo best practices (HTTP conventions, validation, security, performance)
debug_exception	Phân tích stack trace và đề xuất cách fix
optimize_query	Tối ưu JPA/Hibernate query (N+1, projection, indexing, caching)
security_audit	Audit bảo mật Spring Security config (JWT, CORS, CSRF, input validation)
migration_plan	Lên kế hoạch upgrade Spring Boot version (breaking changes, namespace migration)
design_microservice	Thiết kế kiến trúc microservice (package structure, API contracts, communication patterns)

Resources (4 guides)

Resource	URI	Nội dung
Project Structure	guide://spring-boot/project-structure	Cấu trúc package chuẩn cho ứng dụng Spring Boot
Security	guide://spring-boot/security	Checklist bảo mật: JWT, OAuth2, CORS, rate limiting
Layered Architecture	guide://spring-boot/layered-architecture	Kiến trúc phân lớp Controller → Service → Repository
API Design	guide://spring-boot/api-design	Thiết kế RESTful API: versioning, pagination, error handling

Cài đặt

# Clone hoặc copy project
cd mcp-spring-boot-toolkit

# Cài dependencies
npm install

# Build
npm run build

Cách sử dụng

Cấu hình MCP Server

Thêm vào file cấu hình MCP của IDE (ví dụ .kiro/settings/mcp.json, claude_desktop_config.json, hoặc tương đương):

Production (dùng bản build):

{
  "mcpServers": {
    "spring-boot-toolkit": {
      "command": "node",
      "args": ["/đường-dẫn-tới/mcp-spring-boot-toolkit/dist/index.js"]
    }
  }
}

Development (dùng tsx, không cần build):

{
  "mcpServers": {
    "spring-boot-toolkit": {
      "command": "npx",
      "args": ["tsx", "/đường-dẫn-tới/mcp-spring-boot-toolkit/src/index.ts"]
    }
  }
}

Ví dụ sử dụng tools

Tạo Entity:

Tạo entity Product với fields: name (String, not null), price (BigDecimal), description (String), stock (Integer)

Tạo Controller + Service + Repository cho entity:

Tạo full CRUD cho entity Order bao gồm controller, service, repository, DTOs

Phân tích pom.xml:

Phân tích file pom.xml của tôi xem có vấn đề gì về dependency không

Tạo config:

Tạo application.yml cho project dùng PostgreSQL, có security, actuator, swagger, với 2 profiles dev và prod

Ví dụ sử dụng prompts

Review API:

Review controller UserController.java theo best practices

Debug lỗi:

Debug exception này: LazyInitializationException - could not initialize proxy...

Tối ưu query:

Tối ưu query trong OrderRepository, đang bị N+1 khi load OrderItems

Scripts

Script	Mô tả
npm run build	Compile TypeScript → JavaScript (output vào dist/)
npm run dev	Chạy trực tiếp từ source bằng tsx
npm start	Chạy bản đã build

Tech Stack

• Runtime: Node.js
• Language: TypeScript
• MCP SDK: @modelcontextprotocol/sdk
• Validation: Zod
• Transport: stdio

Cấu trúc project

mcp-spring-boot-toolkit/
├── src/
│   ├── index.ts              # Entry point - khởi tạo MCP server
│   ├── tools.ts              # Đăng ký 8 tools code generation
│   ├── prompts.ts            # Đăng ký 6 prompts
│   ├── resources.ts          # Đăng ký 4 resources
│   └── resources/            # Markdown guides
│       ├── project-structure.md
│       ├── security-checklist.md
│       ├── layered-architecture.md
│       └── api-design.md
├── dist/                     # Build output
├── package.json
├── tsconfig.json
└── README.md

License

MIT