An MCP server with Excel file reading, writing, and data manipulation capabilities using FastMCP
Server has 6 tools with basic schemas and descriptions, but significant quality gaps. Descriptions are present but often generic or in Chinese (non-English descriptions reduce LLM utility). Parameter descriptions lack actionable constraints (ranges, enums, formats). No output schemas documented. Error handling is minimal, no recovery guidance or categorization. Tool names are verb-prefixed but some are overly generic ('insert_excel_row' vs 'append_excel_row'). Destructive operations (delete_excel_row) lack confirmation patterns. No tool annotations (readOnlyHint/destructiveHint). Schemas show types but lack depth, many parameters missing descriptions or constraints.
根据行号删除Excel文件中的指定行
获取Excel文件的简要信息,包括工作表统计和前几行数据预览
向指定的单元格插入文本,默认左对齐
向Excel文件中插入行数据,支持批量插入、数据验证、公式计算和格式保持
读取指定的 Excel 文件并返回结构化数据
在Excel文件中搜索指定列的数据并返回匹配的行
Descriptions are in Chinese and lack actionable LLM guidance. E.g., 'read_excel_file' description '读取指定的 Excel 文件并返回结构化数据' does not explain when to use it vs get_excel_summary, what structure is returned, or prerequisites.
Destructive tool 'delete_excel_row' has no confirmation pattern, dry-run option, or recovery guidance. Agents can permanently delete rows without safeguards.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) present. LLMs cannot distinguish safe reads from destructive writes without explicit hints.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | <=2025-11-25 | v2 |
Parameter constraints missing or vague. E.g., 'start_row' and 'end_row' lack min/max bounds; 'match_type' accepts 'exact' or 'contains' but no enum constraint; 'batch_size' has no validation that it stays ≤500.
No output schemas documented. LLMs cannot plan downstream calls or extract required fields. E.g., what does read_excel_file return? A list of dicts? A DataFrame? Column names?