A Spring AI-based MCP server that exposes knowledge document retrieval tools. Includes a Spring Boot MCP server, a Spring AI client, and a Vue.js frontend for agent interaction.
Both tools have identical, generic descriptions ('Get a list of internal technical documents for knowledge clustering') that fail to distinguish their purpose or when to use each. Neither tool has an input schema, both declare empty input objects {}. Tool names lack clarity: 'getCompanyKnowledgeDocuments' vs 'searchWiki' do not follow verb_noun convention and are ambiguous about what distinguishes them. No parameter descriptions, no output schema documentation, no error handling guidance. The code shows hardcoded mock data with no actual integration. This server falls well below production baseline.
Get a list of internal technical documents for knowledge clustering
Get a list of internal technical documents for knowledge clustering
Both tools have identical descriptions ('Get a list of internal technical documents for knowledge clustering'). LLMs cannot distinguish when to call each tool. Descriptions must clarify purpose, scope, and when to use each.
No input schemas defined for either tool. Both declare empty input {} with no parameters, types, or descriptions.
Tool names do not follow verb_noun convention. 'getCompanyKnowledgeDocuments' uses camelCase; 'searchWiki' is inconsistent. Names should be snake_case (get_company_knowledge_documents, search_wiki) and clearly distinguish their scope and filtering behavior.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 23 | 2026-07-28+ | v2 |
No output schema documented. LLMs cannot plan downstream calls or extract fields. The code returns a List<KnowledgeDocument> with fields (title, summary, tags, author, createdDate, department), but this structure is not declared in tool metadata.
No error handling or recovery guidance. If a tool fails, the LLM receives no actionable error message. No validation of inputs, no timeout handling, no fallback suggestions.