--- title: "文件系统与本地执行参考：Filesys - 文件系统与本地执行 | 思行致远" canonical: "https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/infrastructure-filesystem-local-filesys/" dateModified: "2026-06-30" datePublished: "2026-06-30" --- 打开 AI·外脑目录 AI·外脑 [返回专栏首页](https://siyuanailab.com/knowledge/) × 站内搜索 ⌕ 主要栏目 - [AI 核心概念](https://siyuanailab.com/knowledge/ai-core/) - [工作流](https://siyuanailab.com/knowledge/workflows/) - [工具配置与选型](https://siyuanailab.com/knowledge/toolkits/) - [信源与标准](https://siyuanailab.com/knowledge/sources/) - [场景案例 待开发](https://siyuanailab.com/knowledge/scenarios/) - [职业与能力](https://siyuanailab.com/knowledge/career/) 专题 - [从这里开始](https://siyuanailab.com/knowledge/start/) - [获取与安装](https://siyuanailab.com/knowledge/install/) - [建设日志](https://siyuanailab.com/knowledge/ops/) [工作流子目录](https://siyuanailab.com/knowledge/workflows/) 基础设施层 - [浏览器自动化 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/browser-automation/) - [MCP 工具 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/mcp-tools/) - [文件系统与本地执行 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/) - [WF-011 文件系统与本地执行参考：Document Parser Agent](https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/infrastructure-filesystem-local-document-parser-agent/) - [WF-012 文件系统与本地执行参考：file system mcp server](https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/infrastructure-filesystem-local-file-system-mcp-server/) - [WF-013 文件系统与本地执行参考：Filesys](https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/infrastructure-filesystem-local-filesys/) - [WF-014 文件系统与本地执行参考：openmoon ai](https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/infrastructure-filesystem-local-openmoon-ai/) - [WF-015 文件系统与本地执行参考：outline sync](https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/infrastructure-filesystem-local-outline-sync/) - [API 网关与工具路由 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/api-tool-routing/) Skill 生产线 - [目标明确 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/goal-definition/) - [Skill 设计 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/skill-design/) - [代码实现 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/implementation/) - [测试评估 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/testing-evaluation/) Skill 参考库 - [写作与内容 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/writing-content/) - [研究与知识 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/research-knowledge/) - [沟通与协作 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/communication-collaboration/) - [产品与项目 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/product-project/) - [数据与分析 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/data-analysis/) - [创意与设计 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/creative-design/) - [商业与营销 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/business-marketing/) Agent Building 只收录有多步工作流、工作标准、Loop、Harness、工具链或通信机制的真 Agent；不收纯 persona、profile、curated list 或只有 system prompt 的仓库。 - [多 Agent 框架 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/multi-agent-frameworks/) - [工作流编排 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/workflow-orchestration/) - [Sub-agent 模式 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/sub-agent-patterns/) - [Harness 与评估 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/harness-evaluation/) 基础设施层 · 文件系统与本地执行 · 工具解读 · WF-013 # 文件系统与本地执行参考：Filesys 思行致远 · 2026/6/30 · 置信度：低 文件系统本地执行文档处理CLI 一个只暴露安全目录中文件列表和读取能力的轻量 MCP server，并附带 Claude 工具客户端示例。 # Filesys > 一个只暴露安全目录中文件列表和读取能力的轻量 MCP server，并附带 Claude 工具客户端示例。 ## 这个能力解决什么问题 很多本地文件工具一上来就开放读写删，风险过高。Filesys 解决的是一个更窄的问题：让 LLM 只能在预配置的安全目录里列出可见文件、读取指定文件内容和元数据，同时阻止目录穿越。它更像“安全文件读取最小样例”，而不是完整文件管理器。 ## 核心逻辑 输入是 MCP resource 请求或 Claude tools 调用：列出安全目录文件，或读取某个文件名。处理层读取配置中的 base directory；`src/resources.py` 的 `list_files()` 扫描目录，`read_file(filename)` 校验路径后读取文件内容、大小和最后修改时间；`src/server.py` 用 FastMCP 注册 `files://list` 和 `files://read/{filename}` 两个 resource；`claude_tool_client.py` 把 MCP 请求包装成 Claude 可用函数；`interact_with_claude.py` 提供命令行对话。输出是文件列表、文件正文和 metadata。 ## 技术结构 - **config/config.json**：定义唯一允许访问的目录。 - **src/resources.py**：核心安全逻辑，负责目录扫描、文件读取、路径校验和目录穿越防护。 - **src/server.py / run.py**：启动 FastMCP server，注册两个资源 endpoint。 - **claude_tool_client.py**：把 MCP resource 调用转成普通函数，方便 Claude Tools 使用。 - **tests/test_resources.py**：覆盖文件列表和读取逻辑，说明项目至少把资源层作为测试对象。 ## 为什么值得参考 它的参考价值是“极小权限面”：只读、单目录、两个资源、路径校验。这比功能丰富的文件 MCP 更适合作为内部安全基线。对工作流缓存层来说，很多任务只需要让 Agent 读材料，不需要写或删；Filesys 展示了如何把能力边界缩到最小。 ## 为什么不建议直接套用 项目星标低、功能非常基础，README 还要求本地环境文件放 Anthropic API key 才能跑交互脚本；对真实团队来说，认证、审计、文件大小限制、二进制文件处理、编码错误、隐藏文件策略都还不完整。它只支持文件列表和单文件读取，不能处理目录递归、搜索、写结果和批处理。 ## 如何改造成自己的版本 可以把它改造成“只读知识目录 MCP”：配置多个命名 root，每个 root 有说明、允许扩展名、最大文件大小和是否递归；工具返回时带相对路径、mtime、size、hash，禁止返回本机绝对路径；读取大文件时只返回分块摘要或片段。写入能力另做独立 server，不和只读 server 混在一起。 ## 适用场景 - 只需要让 Agent 安全读取指定目录。 - 教学或原型阶段验证 MCP resource 设计。 - 知识库/项目资料不允许 Agent 写入。 ## 不适用场景 - 需要完整文件管理、搜索、写入或批处理。 - 目录中包含敏感密钥或不可直接暴露内容。 - 需要成熟认证、审计和多用户隔离。 ## 公开版边界 - 项目较新，成熟度待验证。 ## 参考信息 - 原项目：[Filesys](https://github.com/OmniS0FT/Filesys) - 作者：OmniS0FT - 相关概念：[[只读文件访问]]、[[MCP Resource]]、[[路径校验]] - 相关卡片：保守留空 ## 参考对象信息 **名称：**Filesys **作者：**OmniS0FT **链接：**[https://github.com/OmniS0FT/Filesys](https://github.com/OmniS0FT/Filesys) ## 适用场景与行动 **场景：**基础设施层 / 文件系统与本地执行 **适合谁：**关注 AI 工作流、Skill 生产和 Agent Building 的读者 **下一步：**先阅读边界说明，再判断它是否适合改造成自己的文件系统与本地执行流程。 当前内容按公开来源和已审核草稿整理，只作为工作流理解与方法论参考。 涉及客户数据、外部平台、会议记录和业务系统的场景，必须保留人工确认与授权边界。 [上一张：文件系统与本地执行参考：file system mcp server](https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/infrastructure-filesystem-local-file-system-mcp-server/) [下一张：文件系统与本地执行参考：openmoon ai](https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/infrastructure-filesystem-local-openmoon-ai/) [返回当前分类](https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/) [返回工作流专栏](https://siyuanailab.com/knowledge/workflows/)