Multi-server MCP orchestrator providing Weaviate knowledge-graph search, code-graph analysis, local model gateway, and Excalidraw diagram integration for Claude Code
13 tools with mixed quality. Most have basic descriptions (50-150 chars) but lack depth on WHEN to use them or prerequisites. Input schemas present but sparse: many parameters lack descriptions or type constraints. No output schemas documented. Error handling absent, no recovery guidance or actionable error messages. Tool naming is verb-forward (search_, list_, create_, update_, delete_) which is good, but composition issues exist: diagram tools (create/update/get/delete/sync/rebuild) are tightly coupled and lack clear separation of concerns. Weaviate and code-graph search tools are well-named but descriptions don't explain when to prefer one over the other. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels (READ_ONLY, WRITE, DESTRUCTIVE). Pagination and result limits not documented.
Generate Mermaid/Excalidraw diagram from code graph analysis
Search code graph for function calls, definitions, and cross-references
Create and manage Excalidraw diagrams with real-time canvas synchronization
Delete an Excalidraw diagram
Generate semantic embeddings for code snippets using CodeSage-Large-v2 model
Generate text using a specified local Ollama model
Retrieve Excalidraw diagram by ID
List all available Excalidraw diagrams
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract required fields (e.g., diagram_id from create_diagram response). Violates pattern:tool and pattern:response-shaper.
Parameter descriptions missing or trivial for most tools. E.g., 'limit' in search_weaviate has no min/max bounds; 'temperature' in generate_with_model lacks range guidance (0.0-1.0 stated in description but not in schema constraints). Violates pattern:constrained-input.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | <=2025-11-25 | v2 |
List available local models from Ollama
Rebuild Weaviate index for diagram metadata and content
Search Weaviate knowledge graph for code and documentation
Real-time canvas synchronization for collaborative diagram editing
Update existing Excalidraw diagram with new elements or modifications
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels declared (READ_ONLY, WRITE, DESTRUCTIVE). delete_diagram and rebuild_diagram_index are destructive but lack confirmation or dry-run support. Violates pattern:confirmation-request.
Diagram tools (create/update/get/delete/sync/rebuild) are tightly coupled with overlapping responsibilities. sync_canvas and update_diagram both modify diagrams; rebuild_diagram_index is a maintenance operation mixed with user-facing tools. Violates pattern:tool (single responsibility).
No error handling guidance. Tools lack recovery hints (e.g., 'If diagram not found, call list_diagrams() first'). No categorization of errors as retryable, user-fixable, or fatal. Violates pattern:recovery-guide and pattern:error-classification.