JohnXu22786/fs-mcp

README 摘要

paddock —— 本地文件系统工作台（MCP stdio server） paddock 为 agent 提供一套完整、受约束的本地文件操作工具：文本读写、目录管理、文件名搜索、正文检索、元信息查询，全部操作被限制在可配置的「围场」目录内，越界访问一律拒绝。 - 零运行时依赖 ：纯 Node.js 标准库实现，无需 npm install - MCP 协议 ：stdio 上的行分隔 JSON-RPC 2.0，可被任意 MCP 客户端加载 - dsh 就绪 ：附 Cordis 桥接插件， bundle 一行接入 harness - 只读模式 ： --read-only 一键拦截全部写操作 - 大文件与二进制 ：流式 head/tail、字节切片、base64 读取、二进制嗅探 - 检索 ：自研 glob 引擎（ ? {a,b} [abc] ）+ 正则/固定串正文搜索 快速开始 启动后即进入 MCP 会话：按行读取 stdin 的 JSON-RPC 消息、按行写回 stdout，日志只走 stderr。 以任意 MCP 客户端接入（以标准 MCP 客户端配置为例）： 也可以直接跑冒烟会话验证： 安装 - 作为 MCP server ：拷贝本目录， node src/entry.js ，无构建步骤。 - 作为 dsh 插件 ：见 docs/INTEGRATION.md。 - 环境要求：Node.js ≥ 18.17（ node --version 检查）。 配置 配置按「默认值 。 开发 测试覆盖：围场越界/符号链接逃逸/祖先链防护、读写往返、大文件与二进制策略、glob 与正文检索、配置三源合并、协议引擎、端到端子进程会话。 许可 MIT，见 LICENSE。

分类