A Python-based MCP server that provides code analysis and question-answering capabilities for repository exploration using embeddings and vector search
Single tool 'qa_endpoint' has a basic description but critically lacks an input schema definition in the source code. The tool accepts a 'question' parameter with a type and description visible in the metadata, but no formal JSON Schema is present in the codebase. The description is adequate (85 chars) but the tool does not follow verb-noun naming (should be 'answer_question' or 'query_codebase'). No output schema is documented. Error handling, parameter validation, and recovery guidance are absent. The tool is read-only but lacks explicit idempotentHint annotation. Overall structure suggests a minimal proof-of-concept rather than production-grade tooling.
Answers questions about the codebase by retrieving relevant code chunks and generating responses using GPT-4o
No input schema visible in source code. Tool metadata shows parameter 'question' with type and description, but no formal JSON Schema definition (type, properties, required fields) is present in main.py or supporting files.
Tool name 'qa_endpoint' does not follow verb_noun convention. Should be 'answer_question', 'query_codebase', or 'search_codebase' to clearly signal the action to the LLM.
No output schema documented. LLMs cannot plan downstream actions or extract structured data without knowing what fields the response contains.
No error handling or recovery guidance. If the question is unanswerable or the codebase is unavailable, the tool provides no actionable error message or next steps for the LLM.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 33 | <=2025-11-25 | v2 |
Read-only tool lacks explicit idempotentHint annotation in schema. This prevents the LLM from confidently retrying on transient failures.