Educational repository demonstrating transformer architecture concepts through Python scripts with mathematical visualizations and step-by-step implementations
Scoring was not performed
No visible MCP server implementation or tool registration code. Repository appears to be educational Python scripts, not a functional MCP server.
Input schema missing type definitions for all parameters. Parameter 'word' and 'model' in get_word_vector lack explicit JSON Schema type declarations (should show 'type: string').
No output schema documentation for either tool. LLMs cannot plan downstream operations or extract required fields without knowing return structure.
No enum constraints on categorical parameters. 'voice' in kokoro_tts accepts string but should enumerate valid voices (e.g. 'af_heart' as shown). 'lang' parameter lacks language code enum.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 25 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 33 | - | v1 |
Tool naming ambiguity: 'kokoro_tts' is acceptable but generic. Better names would be 'generate_speech' or 'synthesize_audio_kokoro' to clarify the action.
No error handling patterns visible. No guidance for LLM recovery if word not found in vocabulary, model unavailable, or TTS synthesis fails.
Parameter descriptions lack detail on format and constraints. 'speed' has no mention of valid range (e.g. 0.5 - 2.0). 'model' says 'Ollama model' but doesn't explain format or discovery mechanism.