matecloud  by mateaix

AI-native, cloud-native DDD microservices framework

Created 6 years ago
1,600 stars

Top 25.3% on SourcePulse

GitHubView on GitHub
Project Summary

Summary MateCloud is an AI-native, cloud-native DDD microservice scaffold accelerating SaaS platform and complex application development. It offers a flexible dual-architecture (monolith/microservice) and integrates advanced AI for developer productivity and operational automation, targeting engineers and power users.

How It Works Built on Spring Boot 4, Spring Cloud 2025, Dubbo 3, and Spring AI 2.0, it employs DDD and CQRS. A key feature is the "MCP Native Engineering Loop," where mate-cli exposes business logic as AI-discoverable @Tools, enabling AI agents to autonomously manage cluster operations like service inspection and code generation. It supports microservice architectures with Nacos and optional monolith deployment.

Quick Start & Requirements

  • Prerequisites: JDK 21+, Maven 3.9+, Docker & Docker Compose, Node.js 20+.
  • Setup: Compile (mvn clean install -DskipTests), start infrastructure (make infra-up), initialize Nacos config (java -jar mate-cli/target/mate-cli.jar config init), and launch services (make up). Frontend: cd mate-ui && pnpm install && pnpm dev.
  • Access: Gateway: 9010, Nacos: 8848, Frontend: 3000.
  • Defaults: admin/admin123. Database auto-initialized via Flyway.
  • Docs: http://localhost:5174 (run pnpm dev:docs in mate-ui).

Highlighted Details

  • AI & MCP Integration: Spring AI 2.0 with @Tool auto-discovery, session memory, streaming, and 6 LLM providers, plus the mate --mcp loop for AI-driven cluster operations.
  • Dual Architecture: Seamless switching between microservice (Spring Cloud + Dubbo 3) and monolith modes.
  • Extensive Starters: 27 plug-and-play starters (18 core, 9 advanced) for persistence, caching, security, observability, AI, multi-tenancy, distributed transactions, etc.
  • Core Patterns: DDD four-layer structure and CQRS pattern.
  • Multi-tenancy: Row-level, schema-level, and independent data source isolation.

Maintenance & Community The project encourages open-source collaboration via PRs and issues, adhering to the Contributor Covenant. Specific community channels or maintainer details are not provided in the README.

Licensing & Compatibility Licensed under Apache 2.0, permitting commercial use with attribution. Generally compatible with closed-source linking.

Limitations & Caveats Requires specific Java (21+) and Node.js (20+) versions. The extensive starter ecosystem and novel AI-driven MCP loop may present a learning curve. Performance benchmarks and known bugs are not detailed.

Health Check
Last Commit

1 day ago

Responsiveness

Inactive

Pull Requests (30d)
14
Issues (30d)
0
Star History
37 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.