{"id":"kayroone-custom-mcp-server","name":"custom-mcp-server","homepage":null,"repo_url":"https://github.com/kayroone/custom-mcp-server","category":"devtools","subcategories":[],"tags":["mcp","model-context-protocol","json-rpc","stdio-transport","java","spring-boot","tools"],"what_it_does":"A learning-oriented MCP (Model Context Protocol) server implemented in Java. It communicates over stdio using JSON-RPC 2.0, supports the MCP initialize handshake, lists tools via tools/list, and executes a basic tool via tools/call (with an echo example).","use_cases":["Learning MCP server basics (initialize, tools/list, tools/call)","Building a simple local MCP server for experimentation","Prototyping tool-calling flows over stdio with JSON-RPC 2.0"],"not_for":["Production-grade MCP deployments","Security-sensitive environments without review/hardening","Use cases requiring robust error handling, logging, resources, or prompts"],"best_when":"You want a small reference implementation to understand MCP interactions end-to-end (server <-> client via stdio).","avoid_when":"You need comprehensive MCP feature coverage (resources/prompts), documented operational behavior, strong security controls, or predictable reliability under failure.","alternatives":["Official or more mature MCP server examples from MCP ecosystem repositories","Custom MCP servers built with clearer production scaffolding (auth, logging, complete feature sets)","Different transport options (if supported by your client) with better-documented implementations"],"af_score":40.8,"security_score":24.8,"reliability_score":15.0,"package_type":"mcp_server","discovery_source":["github"],"priority":"low","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-04-04T20:02:21.437146+00:00","interface":{"has_rest_api":false,"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":["None described"],"oauth":false,"scopes":false,"notes":"No authentication/authorization mechanism is described in the README. For stdio-local use this may be acceptable for learning, but it is not appropriate for untrusted multi-tenant environments without additional controls."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Open-source (MIT) with no hosted pricing model described."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":40.8,"security_score":24.8,"reliability_score":15.0,"mcp_server_quality":55.0,"documentation_accuracy":60.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":95.0,"rate_limit_clarity":0.0,"tls_enforcement":30.0,"auth_strength":5.0,"scope_granularity":0.0,"dependency_hygiene":50.0,"secret_handling":50.0,"security_notes":"Transport is stdio (not TLS). The README does not mention authentication, authorization, or scoping. Planned error handling/logging suggests current operational and security hardening may be incomplete. Dependency hygiene cannot be verified from README; only that Spring Boot/Jackson/Lombok are used.","uptime_documented":0.0,"version_stability":30.0,"breaking_changes_history":20.0,"error_recovery":10.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Only a basic tool set is described (echo example). Agents should not expect resources/prompts or extended tool implementations to be available.","Planned features include error handling and logging; current behavior under failures may be limited.","No rate-limit, timeout, or retry behavior is documented; agents may need conservative pacing and robust handling of malformed/failed responses."]}}