A Spring Boot-based MCP server demonstrating tool integration with calculator, weather, and data model/API finder capabilities
Server has 5 tools with basic schemas and descriptions, but significant quality gaps. Tool names lack action verbs (e.g., 'calculate' instead of 'compute_expression', 'getWeather' instead of 'get_weather'). Descriptions are present but minimal (10-50 chars), below the 50-200 char LLM-optimized baseline. Parameter descriptions exist but are sparse. No output schemas documented. Error handling is minimal, tools return plain strings rather than structured error objects with recovery guidance. The 'executeApi' tool accepts a generic 'parameters' object without validation constraints, inviting hallucinated payloads. No tool annotations (readOnlyHint/destructiveHint) despite clear risk levels.
计算数学表达式的结果
根据用户输入构造参数并调用实际接口
根据数据模型找到对应的接口并暴露参数
根据用户的描述找到数据模型
获取某个城市的实时天气
Tool names lack action verbs and use camelCase instead of snake_case. 'getWeather' should be 'get_weather', 'findModel' should be 'search_model' or 'find_model'. LLMs rely on verb-first naming to infer intent.
Descriptions are too short (10-50 chars, below 50-char minimum). 'Calculate math expression' and 'Get real-time weather' lack context for LLM selection. Should explain WHEN to use, WHAT it returns, and any prerequisites.
No output schemas documented. LLMs cannot plan downstream calls or extract required fields. Tools return plain strings (e.g., 'calculate' returns 'Expression: ... Result: ...') instead of structured JSON with typed fields.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 26 | 2026-07-28+ | v2 |
'executeApi' accepts a generic 'parameters' object without validation constraints, enums, or format hints. LLMs will hallucinate arbitrary payloads. Should validate against a schema and return actionable errors.
No tool annotations (readOnlyHint/destructiveHint/idempotentHint) despite clear risk levels. 'executeApi' is marked WRITE but lacks confirmation/dry-run support. 'calculate' and 'getWeather' are READ_ONLY but not annotated.