Knowledge Base Navigator - MCP server for navigating a local knowledge base with support for Markdown, Org-mode, and plain text documents
KBNavt MCP server has 4 tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema specification. All tools are READ_ONLY and properly named with action verbs (list_, read_, search_). Descriptions exist but are minimal (10-50 chars, below the 194-char baseline). Input schemas are present but lack parameter descriptions, critical for LLM reasoning. No output schemas documented. Error handling is minimal. The server demonstrates basic MCP capability but falls short of production quality.
List all documents in the knowledge base
Read a specific document from the knowledge base
Read a specific section/header from a document
Search documents by keyword
Parameter descriptions missing. 'path' and 'section' parameters lack descriptions explaining expected format, constraints, or examples. LLMs cannot infer whether 'path' is a file path, URI, or internal ID.
Output schemas not documented. No specification of what list_documents, read_document, read_section, or search_documents return. LLMs cannot plan downstream calls or extract required fields without knowing response structure.
Tool descriptions too brief (10-50 chars vs 194-char baseline). 'List all documents in the knowledge base' lacks context on when to call this vs search_documents, what structure is returned, or whether pagination is supported.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 48 | <=2025-11-25 | v2 |
No error handling guidance. Error responses (e.g., 'failed to read resource') do not tell the LLM what to do next or whether the error is retryable. Missing recovery hints.
search_documents 'limit' parameter lacks constraints. No min/max specified; LLMs could pass absurd values (0, 1000000). Should document valid range (e.g., 1-100).