FastMCP-based protein data access tools for bioinformatics research
Three tools with reasonable naming (verb_noun pattern) and basic schemas, but significant gaps in parameter descriptions and output documentation. Tool descriptions are present but generic (10-50 chars in some cases). Parameters lack type constraints (enums, ranges). No error handling guidance. Schema completeness varies: find_protein_structures has good input schema; get_protein_data_tool and download_protein_structure_tool lack documented output schemas. Missing descriptions for several parameters (e.g., 'data_types' array lacks item type details). No mention of idempotency, retry safety, or side effects for the WRITE tool.
蛋白质结构下载工具 - 获取PDB文件和相关数据 这个工具帮助你下载蛋白质结构文件用于本地分析。
蛋白质结构发现工具 - 搜索、示例、验证的统一入口 这是蛋白质研究的起点,帮助你发现和验证PDB结构。
蛋白质综合数据工具 - 获取完整蛋白质信息包 这个工具是蛋白质数据获取的核心,一次性获取你需要的所有信息。
Output schemas not documented. LLMs cannot plan downstream calls or extract required fields (e.g., what does get_protein_data_tool return? Is it a dict, list, or structured object?). Violates pattern:tool requirement for documented return types.
Parameter 'data_types' in get_protein_data_tool is an array but lacks item type specification and enum constraint. Description says 'list' but does not specify valid values or format. LLMs will hallucinate invalid types.
download_protein_structure_tool is marked WRITE but has no error handling guidance, confirmation step, or idempotency declaration. Agents cannot determine if retrying is safe or if the tool has side effects.
Inferred effective spec: 2025-06-18+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | 2025-06-18+ | v2 |
Parameter descriptions lack actionable constraints. 'max_results' says 'default 10, max 100' but no minimum specified. 'format' lists options but no guidance on when to use each. 'save_path' has no validation rules (absolute vs relative, permissions, disk space).
Tool descriptions contain Chinese text mixed with English, reducing clarity for non-Chinese-speaking LLMs. Descriptions should be in a single language (preferably English for broad LLM compatibility).