官方 Filesystem 与 Fetch MCP Server 怎么用:给 Claude Desktop 配本地目录读写白名单与网页抓取

想让 Claude Desktop 读写本地文件夹并抓取指定网页?按 MCP 官方参考服务器仓库整理 Filesystem 与 Fetch 的运行环境、claude_desktop_config.json 白名单写法、常用工具参数与常见报错排查。

NNathaniel bigo··原创首发·AI 辅助撰写
13 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 免费账号 账号

结论先说

  1. Filesystem 和 Fetch 都来自 MCP 官方 modelcontextprotocol/servers 参考仓库,前者基于 Node.js(npx 启动),后者基于 Python(推荐用 uvx 启动)。
  2. Filesystem 靠启动参数限制目录范围:你在 args 数组末尾写进哪几个本地绝对路径,模型就只能访问这几个目录及其子目录,越界会直接报错。
  3. Fetch 会把网页 HTML 转成精简 Markdown,单次默认最多返回 5000 个字符(max_length),长网页靠 start_index 分段往后读。
  4. 官方把这两个服务器定位为参考实现,以你当前登录的系统用户权限运行。不要把整个用户主目录或系统盘根目录放进白名单。
  5. 改完配置必须彻底退出并重开 Claude Desktop,仅关闭窗口不会重新加载本地 MCP 进程。
  6. 主力模型订阅与账号配套入口:跑通 MCP 工具链与多文件智能体编码依赖稳定的底层大模型配额,国内免境外卡自助开通可见本站 Claude Code 订阅页、ChatGPT Plus 充值页 与 AI 会员充值总览。

Filesystem 与 Fetch 官方参考服务器对比

图:本站根据 MCP 官方参考仓库 modelcontextprotocol/servers 整理的示意图

本文根据 MCP 官方参考仓库《modelcontextprotocol/servers》及《Filesystem MCP Server》《Fetch MCP Server》、MCP 官方文档《Connect to local MCP servers》整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 或 MCP 官方网站。

适用于谁

  • 想在 Claude Desktop 里整理本地文档、批量改名或汇总网页资料,搜「filesystem mcp 配置」的人;
  • 不清楚 Filesystem 白名单目录怎么写、为什么 Fetch 要装 uvx 的用户;
  • 已经配好 JSON 却遇到越界报错、网页只抓一半或 robots.txt 拦截的人。

一、运行前先准备两个命令行工具

这两个官方服务器分别用了不同的语言打包,装之前先在终端确认环境:

  1. Node.js(供 Filesystem 使用):运行 node --version 确认已安装 LTS 版本,系统里能直接调用 npx。
  2. uv 或 pip(供 Fetch 使用):官方推荐安装 Python 包管理器 uv,装好后自带 uvx 命令,可以在隔离环境里直接拉起 mcp-server-fetch。如果不装 uv,也可以用 pip install mcp-server-fetch 安装后通过 python -m mcp_server_fetch 启动。

如果你还不熟悉 Claude Desktop 配置文件在哪里打开,可以先看 Claude Desktop MCP 配置教程;想先了解协议原理,见 MCP 是什么。

二、在 Claude Desktop 里同时配好两个服务器

打开 claude_desktop_config.json(macOS 在 ~/Library/Application Support/Claude/,Windows 在 %APPDATA%\Claude\),在 mcpServers 对象里把两项一起写进去。

macOS 与 Linux 写法示例:

json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/你的用户名/Documents/work-notes",
        "/Users/你的用户名/Downloads"
      ]
    },
    "fetch": {
      "command": "uvx",
      "args": [
        "mcp-server-fetch"
      ]
    }
  }
}

Windows 写法示例(注意反斜杠必须双写转义):

json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\你的用户名\\Documents\\work-notes",
        "C:\\Users\\你的用户名\\Downloads"
      ]
    },
    "fetch": {
      "command": "uvx",
      "args": [
        "mcp-server-fetch"
      ]
    }
  }
}

保存文件后完全退出 Claude Desktop 再重新打开。点击输入框左下角的加号图标,在连接器(Connectors)管理列表里看到 filesystem 和 fetch 都处于已加载状态,说明进程启动成功。

三、Filesystem 的工具清单与白名单边界

官方 src/filesystem 说明文档列出了服务器暴露的主要工具:

工具名作用使用注意
read_text_file / read_multiple_files读取单个或多个文本文件内容支持按行读取,一次读多个文件比循环单读更省往返次数
write_file新建文件或完整覆盖已有文件会直接改写磁盘文件,批准前先核对路径
edit_file按匹配块局部替换文件内容支持 dryRun 预览差异,改配置文件和文稿更稳妥
list_directory / create_directory列出目录内容、新建文件夹仅限白名单目录内部
move_file / search_files / get_file_info移动或重命名文件、按模式搜文件、看元数据源路径和目标路径都必须在允许目录内

关于权限边界,有两条实用规则:

  • 只给最小工作目录:比如专门建一个 ai-workspace 文件夹放待处理资料,不要把存有 SSH 密钥、浏览器配置或环境变量的用户主目录放进去。安装第三方服务器前的通用检查项可参考 MCP 服务器怎么选、装之前怎么审。
  • 支持客户端 Roots 协议:如果宿主客户端实现了 MCP 的 Roots 能力,客户端也可以动态向 Filesystem 服务器声明允许访问的根目录;在 Claude Desktop 手动配 JSON 时,仍以 args 传入的绝对路径为准。

四、Fetch 的抓取参数与分段读取方法

官方 src/fetch 服务器只提供一个核心工具 fetch,用来请求指定网址并把网页正文清洗成方便模型阅读的 Markdown。它的四个输入参数很实用:

  1. url(必填):要抓取的网页完整地址。
  2. max_length(可选):单次返回的最大字符数,官方默认值为 5000。
  3. start_index(可选):从第几个字符开始截取,默认从 0 开始。遇到长技术文档被截断时,直接让 Claude「接着上次的位置用 start_index 往后读完」即可。
  4. raw(可选):布尔值,设为 true 时不转 Markdown,直接返回网页原始文本或源码。

默认情况下,Fetch 服务器会先检查目标站点的 robots.txt,如果不允许自动化工具抓取就会拒绝请求。官方提供了两个可选启动参数,写在配置文件 fetch 的 args 里:

  • --ignore-robots-txt:忽略目标站点的 robots.txt 限制(仅在你有权访问且符合目标网站条款时使用);
  • --user-agent="自定义名称":自定义请求头里的 User-Agent 字符串。

五、常见报错与替代思路

Filesystem 与 Fetch 常见异常判断

图:本站根据 MCP 官方参考仓库 modelcontextprotocol/servers 整理的示意图

日常使用中最常碰到四类问题:

  1. Windows 上启动时报 ENOENT 或 ${APPDATA} 路径错误:按 MCP 官方排错说明,在 filesystem 配置下加一个 "env": {"APPDATA": "C:\\Users\\你的用户名\\AppData\\Roaming\\"},并确认执行过 npm install -g npm。
  2. Fetch 抓不到动态渲染网页:mcp-server-fetch 走的是普通 HTTP 请求,不会启动真实浏览器跑前端 JavaScript。遇到必须前端渲染的页面,改用 Playwright 类浏览器 MCP 更合适。
  3. 长文件加长网页很快撞上免费版对话上限:连续读取多份本地文稿和网页正文会消耗较多上下文额度。如果经常卡在 5 小时限额,可以考虑升级 Claude Pro;要是你的日常工作主要是改代码仓库和跑终端脚本,其实不必在桌面版手工配 Filesystem,直接用自带本地读写与抓取工具的 Claude Code 更省事,它的 MCP 扩展方法见 Claude Code MCP 配置教程。
  4. 不确定是服务器挂了还是客户端没连上:先在终端用官方调试器单独跑一遍,具体命令见 MCP Inspector 怎么用。

常见问题

问:Claude Desktop 不是已经有网页搜索了吗,为什么还要装 Fetch?

答:内置联网搜索偏向按关键词检索摘要;Fetch MCP 则是把你指定的具体 URL 正文完整拉下来转成 Markdown,并支持用 start_index 分段读完长页面,适合精读接口文档或指定文章。

问:Filesystem 可以同时配置多个不相邻的文件夹吗?

答:可以。在 args 数组里跟在 @modelcontextprotocol/server-filesystem 后面依次追加多个绝对路径,用英文逗号隔开即可。

问:允许访问某文件夹后,模型修改或删除文件会先问我吗?

答:在 Claude Desktop 里,调用写文件、改文件、移动文件等工具前默认会弹出审批提示。点同意前务必看清传入的目标路径,防止覆盖原稿。

问:用 pip 装了 mcp-server-fetch 但不想装 uv 怎么写配置?

答:把 fetch 的 "command" 改成 "python"(或虚拟环境里 python.exe 的绝对路径),"args" 改成 ["-m", "mcp_server_fetch"] 即可。

问:配置好开发环境后,国内没有外币卡怎么开通 Claude 或 ChatGPT 编程订阅?

答:可在 本站充值中心 自助选购卡密开通 Claude Code(Pro / Max) 或 ChatGPT Plus / Pro,全程无需交出账号密码,支持开具增值税发票;实时价格与售后边界(封号不在质保范围)以对应商品页为准。

相关教程

参考资料

  • MCP 官方参考服务器仓库:https://github.com/modelcontextprotocol/servers
  • Filesystem MCP Server 官方说明:https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem
  • Fetch MCP Server 官方说明:https://github.com/modelcontextprotocol/servers/tree/main/src/fetch
  • MCP 官方文档:Connect to local MCP servers — https://modelcontextprotocol.io/docs/develop/connect-local-servers

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同产品的其他教程

  1. 01

    用 ChatGPT 速读英文产品手册、开源文档与 GitHub Issue 并沉淀团队中文内训手册

    团队引入海外 SaaS 工具或开源框架时,全英文文档晦涩冗长、真正的坑全藏在几十页 GitHub Issue 讨论里。本文分享速读拆解英文手册、归类 Issue 排障库以及重构团队中文内训 SOP 的完整实战流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 写油猴脚本(Tampermonkey)与浏览器书签小工具解决网页繁琐重复操作实战

    每天在后台系统里重复勾选几十个复选框、手工复制网页表格或清理遮挡阅读的侧边栏,既枯燥又浪费时间。本文分享不会写 JS 也能用 F12 配合 ChatGPT 写出油猴脚本与书签小工具的完整实战流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 写高质量 SQL 窗口函数(RANK / LAG / SUM OVER)做留存与漏斗分析实战

    做用户留存率、复购间隔与有序转化漏斗时,多层自连接既难读又拖垮数据库,窗口函数则是高效解法。本文整理数据库方言喂数规范、CTE 分层提示词以及用内置沙盒先验证再上线的完整实战流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 连接 Canva、Figma、Linear、Jira、Dropbox 等第三方应用搜不到数据或授权失效怎么办

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 后,明明显示已连接却搜不到文件工单,或老提示授权失效怎么办?本文拆解账号错绑、OAuth 范围漏选、权限继承与管理员拦截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增强检索)是什么、怎么实现:给文档块自动补背景摘要结合缓存降失误率

    长文档切成小块后丢了公司名、年份和主语指代导致 RAG 频频搜错?本文按 Anthropic 官方技术文章详解 Contextual Retrieval 原理、官方公开评测失误率下降 49% 至 67% 的组合架构,以及用 Claude 提示词缓存低成本批量生成切片背景的完整 Python 代码。

    Claude其他 AI 工具0
  6. 06

    RAG 知识库回答不准怎么调优:切片大小(Chunking)、BM25 + 向量混合检索与 Rerank 重排序三步排查法

    搭好的 RAG 企业知识库一问具体型号、报错码或跨行表格就答非所问?本文按 OpenAI 与 Anthropic 官方检索文档,给出先隔离检索与生成故障、再按结构化切片(Chunking)、BM25 加向量混合召回(RRF)与 Rerank 重排序逐层调优的三步法。

    Claude其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~