{"id":"liqingdong-mcp-server-demo","name":"mcp-server-demo","homepage":null,"repo_url":"https://github.com/liqingdong/mcp-server-demo","category":"devtools","subcategories":[],"tags":["mcp","spring-boot","java","tooling","sse","stdio","demo"],"what_it_does":"An example MCP (Model Context Protocol) server built with Spring Boot 3.4.4, exposing tool-like services via annotations. It includes a NumberService (parity check and prime detection) and a WeatherService (currently described as using random number pseudocode rather than a real third-party API). It supports MCP interaction via STDIO mode and SSE over HTTP.","use_cases":["Learning/demo of building an MCP server with Spring Boot and Spring AI @Tool/@ToolParam","Providing simple calculation tools (odd/even, prime check) to an MCP-capable client","Demonstrating MCP transport options (STDIO and SSE) for tool invocation","Template for extending to real external data (e.g., weather providers)"],"not_for":["Production-ready weather/forecast services (README indicates randomized pseudocode)","Security-sensitive deployments without further hardening and authentication/authorization","Environments requiring rigorous operational/SLA guarantees"],"best_when":"You want a reference implementation to demonstrate MCP tool exposure patterns and basic service logic to a local MCP client.","avoid_when":"You need real, reliable external integrations, fine-grained access control, or production-grade operational controls without verifying the underlying implementation.","alternatives":["Other community MCP server examples in TypeScript/Python","Build directly on the official MCP protocol with a minimal server framework","Use a model/tool orchestration layer that supports tools without running a custom MCP server"],"af_score":30.8,"security_score":24.5,"reliability_score":17.5,"package_type":"mcp_server","discovery_source":["github"],"priority":"low","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-04-04T19:41:38.940278+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":"http://localhost:8081/sse (SSE mode described in README)","has_sdk":false,"sdk_languages":["Java"],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":[],"oauth":false,"scopes":false,"notes":"README does not mention authentication/authorization for either STDIO or SSE modes."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Open-source/demo-style repository; no pricing information provided."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":30.8,"security_score":24.5,"reliability_score":17.5,"mcp_server_quality":45.0,"documentation_accuracy":55.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":20.0,"rate_limit_clarity":0.0,"tls_enforcement":30.0,"auth_strength":10.0,"scope_granularity":0.0,"dependency_hygiene":40.0,"secret_handling":50.0,"security_notes":"No authentication/authorization is described for the MCP server endpoints. README does not mention TLS requirements for SSE. The project uses external configuration via application.yml (details not provided), so secret handling cannot be verified from the README alone.","uptime_documented":0.0,"version_stability":30.0,"breaking_changes_history":20.0,"error_recovery":20.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["WeatherService is described as random pseudocode rather than a real API integration, which may produce unrealistic or non-deterministic results.","No authentication details are documented; some MCP clients or deployment scenarios may require additional transport/security configuration."]}}