--- title: "文件系统与本地执行参考：file system mcp server - 文件系统与本地执行 | 思行致远" canonical: "https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/infrastructure-filesystem-local-file-system-mcp-server/" 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-012 # 文件系统与本地执行参考：file system mcp server 思行致远 · 2026/6/30 · 置信度：低 文件系统本地执行文档处理CLI 一个基于 FastMCP 的本地文件系统工具 server，提供读写、复制、移动、搜索、目录和系统信息工具。 # File System MCP Server > 一个基于 FastMCP 的本地文件系统工具 server，提供读写、复制、移动、搜索、目录和系统信息工具。 ## 这个能力解决什么问题 Agent 要处理本地材料时，不能只靠聊天框上传文件；它需要列目录、读文件、写结果、搜索文件、查看元信息，甚至组织一组相关文件。这个项目解决的是把这些本地文件动作暴露成 MCP 工具，让 Claude 等 MCP host 可以通过结构化 API 操作文件系统。 ## 核心逻辑 输入是 MCP 客户端发出的工具调用，例如 `read_file`、`write_file`、`search_files`、`list_directory`、`get_disk_info`。处理层用 FastMCP 注册工具，用 Pydantic 做参数校验；文件操作前做路径校验，复制/移动/删除支持备份或安全检查；系统信息工具读取 OS、CPU、内存、磁盘和目录统计。输出是文件内容、操作结果、搜索列表、目录树、文件/磁盘元数据或错误信息。 ## 技术结构 - **FastMCP server**：`fs_server.py` 作为 MCP 入口，通过 Python 解释器在 Claude Desktop 配置中启动。 - **File operations**：copy/move/delete/read/write/info/search/create_collection，覆盖读写和组织文件集合。 - **Directory operations**：list/create/delete/tree/search，适合让 Agent 探索工作区结构。 - **System information**：system/disk/directory info，给 Agent 判断空间、平台和目录规模。 - **平台差异**：README 明确 Windows 功能更完整，macOS/Linux 只有基础文件和目录能力，未来计划补齐平台工具。 ## 为什么值得参考 它适合作为“文件 MCP 最小工具面”的清单：哪些动作应该开放、哪些动作需要安全检查、哪些元信息对 Agent 有用。README 还直接列出 Known Issues，说明删除、驱动器检测、跨平台行为都不能想当然。 ## 为什么不建议直接套用 项目星标很低，README 明确 `delete_file` 有已知问题，`list_drives` 也可能不准；跨平台能力偏 Windows，macOS/Linux 支持较薄。它包含写入、移动、删除等高风险工具，若直接接到 Agent，误操作成本很高。路径校验和备份策略需要实际代码审计，不能只凭 README 信任。 ## 如何改造成自己的版本 内部文件 MCP 应从只读开始：`list_directory`、`read_file`、`search_files`、`get_file_info` 先上线；写入工具只允许写到指定 output 目录；删除和移动默认禁用。每个工具都要带 workspace root、最大文件大小、允许扩展名和审计日志。等只读稳定后，再引入“写草稿文件”和“复制备份”这类低风险动作。 ## 适用场景 - 本地知识库、项目目录、文档批处理的 MCP 文件访问。 - 需要让 Agent 搜索和读取多个本地文件。 - 想参考文件工具命名和权限分层。 ## 不适用场景 - 直接开放删除/移动给无人监督 Agent。 - 需要成熟跨平台生产级文件管理。 - 文件包含密钥、隐私或不可恢复资产。 ## 公开版边界 - 项目较新，成熟度待验证。 ## 参考信息 - 原项目：[file-system-mcp-server](https://github.com/calebmwelsh/file-system-mcp-server) - 作者：calebmwelsh - 相关概念：[[MCP]]、[[本地文件系统]]、[[权限边界]] - 相关卡片：保守留空 ## 参考对象信息 **名称：**file-system-mcp-server **作者：**calebmwelsh **链接：**[https://github.com/calebmwelsh/file-system-mcp-server](https://github.com/calebmwelsh/file-system-mcp-server) ## 适用场景与行动 **场景：**基础设施层 / 文件系统与本地执行 **适合谁：**关注 AI 工作流、Skill 生产和 Agent Building 的读者 **下一步：**先阅读边界说明，再判断它是否适合改造成自己的文件系统与本地执行流程。 当前内容按公开来源和已审核草稿整理，只作为工作流理解与方法论参考。 涉及客户数据、外部平台、会议记录和业务系统的场景，必须保留人工确认与授权边界。 [上一张：文件系统与本地执行参考：Document Parser Agent](https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/infrastructure-filesystem-local-document-parser-agent/) [下一张：文件系统与本地执行参考：Filesys](https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/infrastructure-filesystem-local-filesys/) [返回当前分类](https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/) [返回工作流专栏](https://siyuanailab.com/knowledge/workflows/)