A Model Context Protocol server for research assistance with ChromaDB vector storage
Five tools with basic descriptions and schemas, but significant gaps in parameter documentation and output structure. Tool names follow verb_noun convention (save_, search_, list_, delete_, get_). Descriptions exist but are brief (avg ~60 chars, below 194-char baseline). Input schemas present with types, but parameter descriptions are minimal or missing. No output schemas documented. Error handling returns plain strings rather than structured guidance. Duplicate detection and topic organization are implemented, but composition and chaining support are weak.
Delete a research topic and all its data.
Get detailed information about a research topic.
List all available research topics (vector databases).
Save research content to vector database for future retrieval.
Search through saved research data using semantic similarity.
No output schemas documented. All tools return plain strings; LLMs cannot parse structured results or chain calls. E.g., search_research_data returns formatted text instead of {results: [{content, similarity_score, metadata}], total_count}.
Parameter descriptions are minimal or absent. 'content' param in save_research_data lacks guidance on expected format, length, or content type. 'topic' param lacks explanation of naming rules (spaces → underscores). LLMs cannot infer constraints.
Error handling returns plain strings with no recovery guidance. E.g., 'Error saving research data: {str(e)}' gives LLM no actionable next step. Should return structured errors with retry classification and suggestions.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 51 | 2026-07-28+ | v2 |
delete_research_topic is destructive but lacks confirmation/dry-run support. No warning in description that this irreversibly deletes all data for a topic. Agents should confirm before executing.
Tool composition is weak. search_research_data returns formatted text, not structured data with topic/doc_id references. Agents cannot chain results into downstream tools (e.g., delete specific documents, update metadata).