Template project for SpringBoot + MCP + JUnit providing weather and number utility tools
This server has severe definition quality issues. Only 2 tools are present, both with minimal documentation. Tool descriptions are provided but extremely brief (10-20 chars), failing the 10-1024 char guideline for good descriptions. The 'getWeather' tool has a description in Chinese ('通过城市名字获取温度[伪]' = 'Get temperature by city name [pseudo]') with no English equivalent, severely limiting LLM comprehension. The 'judgeIfOdd' tool description is also Chinese ('判断是否是双数' = 'Judge if it is an even number') and contains a semantic error (the name says 'Odd' but description says 'even'). Neither tool has documented output schemas. Parameter descriptions are minimal or missing: 'cityName' has null description, 'num' has only 'waiting to be judged number' in English. No error handling guidance is provided. Tools are defined in test files (SSETest.java), suggesting these are demo/test implementations rather than production-ready. The tool names themselves are weak: 'getWeather' and 'judgeIfOdd' lack clarity, 'getWeather' doesn't specify what it returns (temperature only? forecast?), and 'judgeIfOdd' is semantically incorrect (should be 'checkIfEven' if it judges even numbers).
通过城市名字获取温度[伪]
判断是否是双数
Tool descriptions are under 20 characters and in Chinese only. 'getWeather' description is 24 chars in Chinese with no English translation. 'judgeIfOdd' is similarly minimal.
Input parameter descriptions are missing or null. 'cityName' has null description. 'num' description is vague ('待判断的数').
No output schema documentation. The tools return values (temperature, boolean), but no schema is visible in source code. Tools that return structured data without documented schemas are unratable for downstream composition.
Semantic error in tool naming: 'judgeIfOdd' suggests the tool checks if a number is odd, but the description says '双数' (even number). This is a critical naming-description mismatch that will confuse LLMs.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 31 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 24 | - | v1 |
Tool definitions are in test files (src/test/java/top/dreamcenter/mcp/SSETest.java), not production source. This suggests tools are demo implementations, not meant for real use.
No error handling or recovery guidance. Tools provide no error messages, validation rules, or guidance for LLM recovery on failure.