任务删除
delete_task
从本地任务板删除任务，适合清理误建、重复或已经不再需要推进的待办。
2 个参数4 个返回字段
参数说明
要删除的任务 ID。
任务存储 JSON 文件路径。
返回字段说明
实际写入的任务文件路径。
被删除的任务 ID。
被删除任务的标题。
删除后剩余的任务数。
工具测试
本 MCP 服务器内包含的工具
任务状态更新
update_task_status
只更新任务状态并写入历史记录，适合任务流转、完成确认和附带简短处理备注。
4 个参数2 个返回字段
参数说明
要更新的任务 ID。
新的任务状态。
任务存储 JSON 文件路径。
附加说明，会写入任务历史。
返回字段说明
实际写入的任务文件路径。
更新后的完整任务对象。
工具测试
任务列表
list_tasks
按状态、负责人、优先级或标签筛选任务，适合做待办盘点、推进跟踪和日报汇总。
7 个参数5 个返回字段
参数说明
任务存储 JSON 文件路径。
只看某个状态的任务。
只看某个负责人名下的任务。
只看某个优先级的任务。
只看包含某个标签的任务。
是否把已完成任务也纳入结果。
最多返回多少条任务。
返回字段说明
实际读取的任务文件路径。
本次生效的筛选条件。
筛选后的任务列表。
本次返回的任务数。
任务文件中的总任务数。
工具测试
任务写入
upsert_task
创建或更新本地任务卡片，适合把 AI 员工的待办、负责人、优先级和补充信息结构化保存。
10 个参数4 个返回字段
参数说明
任务标题。
已有任务 ID；传入后会更新原任务。
任务补充说明。
负责人或执行角色。
任务状态，如 `todo`、`in_progress`、`done`。
优先级，如 `low`、`medium`、`high`、`urgent`。
截止日期或时间说明。
任务标签数组。
额外业务字段，便于后续扩展。
任务存储 JSON 文件路径。
返回字段说明
本次是 `created` 还是 `updated`。
实际写入的任务文件路径。
最新任务对象。
当前任务文件中的任务总数。
工具测试
网页正文抓取
fetch_webpage_text
拉取网页正文、标题、摘要和可选链接，适合做竞品研究、信息采集和网页转文本。
4 个参数8 个返回字段
参数说明
要抓取文本的网页地址。
最大返回字符数，超出会截断。
抓取超时时间（毫秒）。
是否顺带提取页面中的链接列表。
返回字段说明
最终响应落到的网页地址。
HTTP 响应状态码。
响应内容类型。
抓取到的网页标题。
页面摘要描述。
抽取出的正文文本。
提取出的链接列表；仅在启用时返回。
提取出的链接数量。
工具测试
CSV 预览
read_csv_preview
读取 CSV 的表头和前几行预览，适合先理解字段结构，再决定是否继续批量处理。
2 个参数6 个返回字段
参数说明
目标 CSV 文件路径。
最多返回多少行数据预览。
返回字段说明
相对 `allowed_root` 的文件路径。
识别出的 CSV 分隔符。
表头字段名列表。
按字段名映射后的前几行数据。
除表头外的数据总行数。
是否因为 `max_rows` 限制而被截断。
工具测试
最近文件
list_recent_files
按修改时间倒序列出最近更新的文件或目录，适合快速定位最新生成的产物。
4 个参数4 个返回字段
参数说明
要查看的目录或文件路径。
路径匹配规则，例如 `**/*.md`。
最多返回多少条记录。
是否把目录本身也算进结果。
返回字段说明
本次统计的起始路径。
本次使用的匹配规则。
本次结果数量上限。
按时间倒序排列的文件/目录列表。
工具测试
文本搜索
search_text_in_files
在允许目录内递归搜索文本内容，适合找报错关键词、配置项、函数名或业务术语。
6 个参数7 个返回字段
参数说明
要搜索的关键词或短语。
开始搜索的目录或文件路径。
路径匹配规则，例如 `**/*.py`。
是否区分大小写。
最大返回匹配条数。
超过该大小的文件会被跳过，避免扫描过慢。
返回字段说明
本次搜索使用的关键词。
本次搜索的起始路径。
实际扫描过的文本文件数。
因二进制判断而跳过的文件数。
因过大而跳过的文件数。
匹配结果数组，每项包含文件路径、行号和行内容。
是否因为达到 `max_results` 而提前截断。
工具测试
JSON 写入
write_json_file
把对象或数组写成 JSON 文件，适合保存任务清单、采集结果、配置快照等结构化数据。
4 个参数4 个返回字段
参数说明
目标 JSON 文件路径。
要写入的 JSON 数据。
文件已存在时是否覆盖；默认 `true`。
是否格式化输出为易读 JSON。
返回字段说明
相对 `allowed_root` 的文件路径。
写入文件的总字节数。
写入数据的顶层结构摘要。
本次是否以格式化方式写出。
工具测试
JSON 读取
read_json_file
读取并解析 JSON 文件，适合查看配置、结构化任务结果和数据缓存内容。
1 个参数4 个返回字段
参数说明
目标 JSON 文件路径。
返回字段说明
相对 `allowed_root` 的文件路径。
MCP 允许访问的根目录。
JSON 顶层结构摘要，如对象键数或数组长度。
解析后的 JSON 原始数据。
工具测试
文本替换
replace_text_in_file
在文本文件中查找并替换指定内容，适合修正文案、替换占位符或做小范围配置更新。
4 个参数3 个返回字段
参数说明
目标文本文件路径。
要被查找的原始文本。
替换后的文本内容。
最大替换次数；`0` 表示全部替换。
返回字段说明
相对 `allowed_root` 的文件路径。
实际完成的替换次数。
文件内容是否发生变化。
工具测试
文本追加
append_text_file
向现有文本文件尾部继续追加内容，适合持续记日志、写进展、补工作痕迹。
3 个参数3 个返回字段
参数说明
目标文本文件路径。
要追加到末尾的文本内容。
必要时自动在前面补换行，避免内容粘连。
返回字段说明
相对 `allowed_root` 的文件路径。
本次追加的字符数。
本次追加的字节数。
工具测试
文本写入
write_text_file
把文本一次性写入文件，适合生成日报、总结、说明文档或工具产出结果。
4 个参数4 个返回字段
参数说明
目标文本文件路径。
要写入的完整文本内容。
文件已存在时是否覆盖；默认 `false`。
是否确保文件末尾补一个换行符。
返回字段说明
相对 `allowed_root` 的文件路径。
本次写入的字节数。
本次写入的字符数。
是否覆盖了已有文件。
工具测试
创建目录
create_directory
在允许目录内创建文件夹，适合在写报告、落截图、存任务文件前先准备工作空间。
2 个参数3 个返回字段
参数说明
要创建的目录路径，必须位于允许目录之内。
目录已存在时是否直接复用；默认 `true`。
返回字段说明
相对 `allowed_root` 的目录路径。
这次调用是否真正新建了目录。
调用结束后目录是否存在。
工具测试
网页截图
screenshot_webpage
抓取网页 PNG 截图，支持整页、移动端尺寸、等待选择器，以及直接返回 Base64。
14 个参数6 个返回字段
参数说明
要截图的网页地址，只允许 `http://` 或 `https://`。
PNG 输出路径；设为 `null` 且启用 `return_base64` 时，可只返回 Base64。
桌面视口宽度；使用 `device_preset` 时会被覆盖。
桌面视口高度；使用 `device_preset` 时会被覆盖。
是否抓取整页，而不只是当前视口。
页面导航完成判定，如 `load`、`networkidle`。
等待某个 CSS 选择器出现后再截图。
等待选择器的状态，如 `visible`、`attached`、`hidden`。
页面加载后额外等待的毫秒数。
截图超时时间（毫秒）。
是否启用移动端触控/移动视口模拟。
Playwright 设备预设名，例如 `iPhone 14`。
设备像素比；桌面自定义视口时生效。
是否在结果里额外返回 PNG 的 Base64 字符串。
返回字段说明
输出文件相对于 `allowed_root` 的路径；仅当实际写文件时返回。
最终截图字节数。
实际截图时使用的视口宽度。
实际截图时使用的视口高度。
实际调用的浏览器二进制路径。
仅当 `return_base64=true` 时返回。
工具测试
磁盘占用
disk_usage
查看目标路径所在文件系统的容量情况，适合快速判断磁盘余量。
1 个参数4 个返回字段
参数说明
目标路径；默认值为当前允许目录根。
返回字段说明
请求对应的目标路径。
磁盘总容量。
已使用容量。
剩余可用容量。
工具测试
文本读取
read_text_file
读取允许目录中的 UTF-8 文本文件，超长内容会被安全截断。
2 个参数5 个返回字段
参数说明
目标文本文件路径，必须位于允许目录之内。
最大返回字符数；默认 `8000`。
返回字段说明
相对 `allowed_root` 的文件路径。
MCP 允许访问的根目录。
是否因为超长而被截断。
读取到的文本内容。
文件原始总字符数。
工具测试
目录浏览
list_files
列出允许访问目录中的文件与子目录，不会越过 `allowed_root`。
1 个参数3 个返回字段
参数说明
相对或绝对路径；默认值为当前允许目录根。
返回字段说明
当前被列举的目录路径。
MCP 允许访问的根目录。
目录项数组，每项包含 `name`、`path`、`type`、`size`。
工具测试
服务器时间
server_time
返回当前服务器时间、时区和主机名，适合做环境探测。
0 个参数3 个返回字段
参数说明
无参数
返回字段说明
ISO 8601 时间字符串。
当前服务使用的时区名称。
服务器主机名。
工具测试
服务探活
ping
最简单的探活工具，用来确认 MCP 会话和服务端执行链路是否正常。
1 个参数1 个返回字段
参数说明
要回显的文本；不传时默认返回 `pong`。
返回字段说明
服务端回显的文本内容。
工具测试