{"id":"ramzus-spring-ai-mcp-server-demo","name":"spring-ai-mcp-server-demo","homepage":null,"repo_url":"https://github.com/Ramzus/spring-ai-mcp-server-demo","category":"ai-ml","subcategories":[],"tags":["ai-ml","mcp","spring-boot","java","docker-compose","microservices","demo","agentic"],"what_it_does":"A Docker-compose demo microservices platform (Orders, Payments, Incidents, and an AI Assistant) where Spring Boot REST APIs persist business data and are exposed to AI agents via Model Context Protocol (MCP) servers, configured for use in tools like VS Code MCP integration.","use_cases":["Demoing agent-to-application integration using MCP","Simulating business workflows: listing/moving order states, creating payments, filtering incident tickets","Building and testing MCP server patterns in Java/Spring Boot","Local development sandbox for AI-augmented operational workflows"],"not_for":["Production deployments handling real payments without adding authentication, authorization, and proper security controls","Environments requiring formal SLAs, documented error contracts, or mature operational guarantees","Use as-is for compliance/regulatory workloads (no compliance details provided)"],"best_when":"Used locally or in a sandbox to prototype AI agent workflows against business-style REST APIs and MCP tooling.","avoid_when":"Avoid using it as a production system without implementing authz, transport/security hardening, and verifying persistence and idempotency semantics for business operations.","alternatives":["Official MCP server templates/examples in the MCP ecosystem","Agent frameworks that provide tool calling over HTTP/SDKs (without MCP)","Spring Boot REST APIs with OpenAPI + generated clients for agent tool use","Managed integration platforms for AI agents (e.g., tool/function calling with secured gateways)"],"af_score":37.8,"security_score":25.5,"reliability_score":26.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"low","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-04-04T19:41:18.217093+00:00","interface":{"has_rest_api":true,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":[],"oauth":false,"scopes":false,"notes":"The README mentions an optional 'Add Authentication' future task, but does not document any authentication/authorization for the REST APIs or MCP servers in the current demo."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information provided; appears to be a self-hosted demo repository."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":37.8,"security_score":25.5,"reliability_score":26.2,"mcp_server_quality":55.0,"documentation_accuracy":55.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":20.0,"rate_limit_clarity":10.0,"tls_enforcement":40.0,"auth_strength":10.0,"scope_granularity":10.0,"dependency_hygiene":40.0,"secret_handling":35.0,"security_notes":"No auth/authz is documented. Demo uses HTTP local ports and Docker; TLS is not addressed. No information about secret management, dependency vulnerability posture, or RBAC/scopes. Recommend adding TLS termination, authentication, and least-privilege authorization before any non-demo use.","uptime_documented":0.0,"version_stability":30.0,"breaking_changes_history":30.0,"error_recovery":45.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["No documented idempotency guarantees for operations like 'Create a payment' or 'Move order stage'; agents may repeat actions on uncertainty/retries.","Rate limits are not mentioned; agents may generate excessive requests unless externally constrained.","Authentication/authorization is not documented; agent calls may be implicitly trusted in this demo setup.","Pagination style is not described; agents may need guidance for listing endpoints if result sets grow beyond demo sizes."]}}