MCP server for filesystem search and manipulation with granular search, content search and file edits
This server exposes 8 tools with mixed quality. Naming is generally action-oriented (excel_edit, exec_command, fs_read, fs_write, fs_ops, fs_search, generate_image, kb_search), which is good. However, critical issues emerge in schema completeness, parameter descriptions, and output documentation. Most tools lack explicit parameter type definitions visible in the schemas provided. Descriptions exist but are often generic or translated (Chinese descriptions suggest possible translation artifacts). No explicit error handling patterns are documented. The server bundles multiple operations under single tools (excel_edit combines 7 different edit types; fs_ops combines 5 operations), which reduces clarity for LLM tool selection. Security concerns are present: exec_command allows arbitrary Python execution with minimal visible restrictions, and several tools perform write operations without documented permission gates.
精确编辑 Excel 文件的特定部分。整合了 30+ 个 Excel 编辑工具,通过 edit_type 参数区分:cells、formula、format、range、sheet_ops、row_col_ops、chart
执行 Python 代码或文件。支持直接执行 Python 代码字符串或执行 Python 文件,可传递命令行参数。包含语法检查(lint)、超时限制、资源限制。
文件系统操作。支持列目录、创建目录、移动、删除、获取信息、Excel 元数据等。
读取文件。支持单文件/多文件,自动识别格式(text、xlsx、csv、docx、pptx、pdf),返回格式化内容。支持行号范围、大纲提取等。
搜索文件名或内容。支持 glob 模式、正则表达式、大小写敏感性选项。
创建/覆盖文件。自动识别格式(text、xlsx、csv、docx、pptx、pdf),支持 lint 检查。
生成图像(数据图表、Mermaid 流程图或 HTML 渲染)。支持多种图表类型(bar、line、pie、scatter)和自定义配置。
exec_command tool allows arbitrary Python execution without visible sandboxing, resource limits, or permission gates. Dockerfile shows setup for 'sandbox' user, but no documentation that exec_command actually uses it or enforces limits.
No output schemas documented for any of the 8 tools. LLMs cannot infer what fields to expect in responses, preventing proper chaining and downstream tool calls. E.g., fs_read should return {path, content, format, line_count?}, but this is not specified.
fs_ops, excel_edit, and generate_image violate single-responsibility principle by bundling multiple operations under one tool. fs_ops combines list/mkdir/move/delete/info (5 operations); excel_edit combines 7 edit types. This forces LLMs to reason about which sub-operation to use, increasing cognitive load and error likelihood.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | D | 54 | <=2025-11-25 | v2 |
| 2026-03-09 | F | 36 | - | v1 |
企业知识库 glob 搜索(不区分大小写),返回匹配文件列表。支持关键词提取、评分排序。
Parameter descriptions are often generic or ambiguous. E.g., 'sheet' is 'optional' but no guidance on default behavior if omitted. 'style' in excel_edit is described as 'style dictionary' without listing valid keys. 'chart_data' in generate_image accepts 'JSON object or string' but no schema detail. Many parameters lack explicit type constraints (string length, numeric range).
WRITE operations (fs_write, excel_edit, fs_ops delete, generate_image) do not document confirmation/dry-run patterns or idempotency guarantees. Agents cannot safely retry without risking duplicate writes or data loss.
No documented error handling or recovery guidance. Tools do not specify what errors are retryable (network timeout) vs user-fixable (invalid path) vs fatal (permission denied). LLMs have no guidance on next steps when a tool fails.
generate_image has mutually exclusive parameters (chart_data, mermaid_code, html_code) but does not document this constraint. Schema does not specify what happens if multiple are provided or if none are provided.
fs_read accepts 'path' as 'single file path or file list' but schema type is unclear (string vs array). fs_search and kb_search do not document pagination or what happens when results exceed limits. kb_search allows up to 50 results but no next_cursor or offset for pagination.
Tool descriptions reference Chinese text ('精确编辑 Excel 文件的特定部分', '执行 Python 代码或文件') suggesting possible translation or localization issues. English descriptions for non-English-speaking developers may be machine-translated and lack clarity.