MCP Server providing user query tools and documentation resources
Single tool 'query_user' has a basic schema and description but significant gaps. Description is in Chinese and lacks English clarity for international LLM use. Input schema uses Zod but is not properly documented in the output. No output schema documented. Error handling is minimal (returns text in content array but no structured error classification). Tool name lacks action verb clarity ('query' is weak; 'get_user' would be stronger). No parameter constraints (userId accepts any string; should validate against enum ['001', '002', '003']). No pagination, no idempotency hints, no permission gates. Resource registration present but not a tool.
查询数据库中的用户信息。输入用户ID, 返回该用户的详细信息(姓名、邮箱、角色)
Tool name 'query_user' lacks action verb clarity. 'get_user' or 'fetch_user' would better signal intent to LLMs. Current name is ambiguous about what 'query' means.
Description is in Chinese only. International LLMs and English-speaking agents cannot understand the tool's purpose. Descriptions must be in English for production use.
Input parameter 'userId' accepts any string but should be constrained to enum ['001', '002', '003']. Free-form strings invite hallucinated invalid IDs. No validation or constraint declared.
Output schema not documented. LLMs cannot predict the response structure (content array with text field). Must document return type explicitly.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 40 | 2026-07-28+ | v2 |
Error handling returns unstructured text ('用户 ID ... 不存在'). Should return structured error with recovery guidance: 'User not found. Valid IDs: 001, 002, 003' in English.