跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PythonAI

Windows 配置 Claude Desktop 与 MCP 实现本地文件读写

在 Windows 系统下配置 Claude Desktop 客户端及 MCP 服务的方法,通过修改配置文件指定本地文件夹路径并安装 Python 依赖,实现 AI 模型直接读取和编辑本地文件的功能。配置步骤包括安装客户端、登录、编辑 MCP Servers 配置文件、安装 mcp 包及重启客户端。验证连接成功后,可执行读取文件、新建编辑文件、批量处理文档及代码编辑等操作,显著提升办公与开发效率。常见问题涉及 Python 环境配置、路径权限及客户端重启等。

小熊软糖发布于 2026/4/6更新于 2026/9/10104 浏览

一、前置准备:先搞定这 2 件事

配置前先确认你已经准备好以下两个基础条件。

  1. 安装 Claude Desktop 客户端:必须是官方原生版本,第三方封装的可能没有 MCP 功能。直接去官方下载:claude.ai/download,下载 Windows 版(x64 或 ARM64,根据自己电脑配置选择),双击安装,一路下一步即可。
  2. 完成客户端登录:安装后打开,选择登录方式——要么用 Anthropic 账号(免费/Pro/Max 都可以),要么用 API Key 登录(适合开发者),登录成功后进入主界面,确保能正常发起对话。

小提醒:如果之前装过 Claude Desktop,建议更新到最新版本,旧版本可能出现配置后无法连接的问题。

二、核心步骤:3 步配置 MCP 本地文件工具

这部分是重点,全程不用复杂操作,复制粘贴即可完成,每一步都标清楚了,跟着做就对了!

第一步:找到 MCP 配置文件

  1. 打开 Claude Desktop 客户端,点击右上角的「Settings」(设置图标,像齿轮一样);
  2. 在设置页面下滑,找到「MCP Servers」选项,点击进入;
  3. 点击「Open config file」(打开配置文件),系统会自动弹出一个 JSON 格式的配置文件,路径通常是:%APPDATA%\ClaudeDesktop\claude_desktop_config.json(不用记路径,点击按钮会自动打开)。

第二步:粘贴配置内容(关键一步)

  1. 清空当前配置文件里的所有内容(全选 → 删除);
  2. 复制下面这段配置代码,粘贴到空的配置文件中:
{"mcpServers": {"filesystem": {"command": "python","args": ["-m","mcp.server.filesystem","--allowed-paths","C:/Users/你的用户名/允许 Claude 访问的文件夹"]}}}
  1. 唯一需要修改的地方:将 C:/Users/你的用户名/允许 Claude 访问的文件夹 替换成你电脑上的真实路径。

举两个常见示例(根据自己的需求修改):

  • 如果想让 Claude 访问你的文档文件夹:C:/Users/ZhangSan/Documents(ZhangSan 替换成你的电脑用户名);
  • 如果想让 Claude 访问你的工作文件夹:D:/work/AI 项目(注意路径用 / 而不是 \,Windows 系统两种都支持,但用 / 更不易出错)。
  • 重要提醒:为了电脑安全,不要给 Claude 开放整个 C 盘或系统盘,只开放一个专门用于存放需要 AI 处理文件的文件夹即可,避免误操作。

    第三步:安装 MCP 服务并重启客户端

    1. 确保你的电脑安装了 Python 3.10 及以上版本(如果没装,先去 Python 官网下载安装,记得勾选'Add Python to PATH');
    2. 打开 Windows 自带的 CMD 或 PowerShell(按下 Win + R,输入 cmd 回车即可);
    3. 在命令行中输入以下命令,安装 MCP 服务:
    pip install mcp 
    
    1. 等待安装完成(出现'Successfully installed mcp-xxx'即表示安装成功);
    2. 关掉 Claude Desktop 客户端,重新打开(必须重启,配置才能生效)。

    三、验证配置:确认 MCP 已连接

    重启 Claude Desktop 后,再次进入「Settings → MCP Servers」,如果看到「filesystem → connected」(绿色连接状态),就说明配置成功了!

    如果显示'disconnected',可以检查这 3 点:

    • Python 是否安装成功,命令行输入 python --version 能显示版本号;
    • 配置文件中的路径是否正确,有没有写错用户名或文件夹名称;
    • 是否重启了 Claude Desktop,配置修改后必须重启才能生效。

    四、实用场景:配置完成后能做什么?

    配置好之后,就可以让 Claude 直接操作本地文件了,这些场景适用,效率提升:

    1. 读取本地文件:直接跟 Claude 说'读取 D:/work/test.md 的内容',AI 会直接获取文件内容,不用手动上传;
    2. 新建/编辑文件:比如'在 D:/work 下新建一个 demo.py,写一个简单的 Python 爬虫',AI 会直接创建文件并写入内容;
    3. 批量处理文档:'帮我整理 D:/work/文档 文件夹里的所有 Word 文件,提取关键信息并生成汇总表格';
    4. 代码编辑:'找到 D:/work/code 文件夹里所有 .js 文件,批量修改其中的变量名,将 var 替换成 let';
    5. 文件夹整理:'帮我分类 D:/work/图片 文件夹里的图片,按格式(jpg/png)分文件夹存放,并统一重命名'。

    再也不用来回切换浏览器、上传下载文件,Claude 就像一个本地助手,直接帮你处理各种文件操作,节省大量时间。

    五、常见问题排查(新手必看)

    配置过程中可能会遇到一些小问题,这里整理了最常见的 3 种,教你快速解决:

    1. 问题 1:CMD 中输入 pip install mcp 提示'pip 不是内部或外部命令' 解决:安装 Python 时没勾选'Add Python to PATH',重新安装 Python,勾选该选项,或手动配置环境变量。
    2. 问题 2:MCP 显示 connected,但 Claude 无法读取文件 解决:检查配置文件中的路径是否正确,确保文件夹存在;另外,文件夹不要设置过高的权限(比如系统盘的隐藏文件夹)。
    3. 问题 3:重启 Claude 后,MCP 仍然显示 disconnected 解决:删除配置文件,重新粘贴配置内容,确保路径格式正确(用 / 分隔),然后重新安装 mcp(pip uninstall mcp 后再 pip install mcp),重启客户端。

    六、总结

    Claude Desktop + MCP 本地文件工具的配置,本质上就是让 AI 拥有了'访问本地文件'的权限,看似简单的一步,却能极大提升日常办公和开发效率。

    整个配置过程不到 10 分钟,全程复制粘贴,新手也能轻松上手。配置完成后,你会发现 AI 不再是'云端工具',而是能直接融入本地工作流的助手,处理文件、编辑代码都变得更高效、更便捷。

    目录

    1. 一、前置准备:先搞定这 2 件事
    2. 二、核心步骤:3 步配置 MCP 本地文件工具
    3. 第一步:找到 MCP 配置文件
    4. 第二步:粘贴配置内容(关键一步)
    5. 第三步:安装 MCP 服务并重启客户端
    6. 三、验证配置:确认 MCP 已连接
    7. 四、实用场景:配置完成后能做什么?
    8. 五、常见问题排查(新手必看)
    9. 六、总结

    更多推荐文章

    查看全部
    • whisper.cpp 性能优化与编译配置指南
    • MySQL 8.0 Windows 安装与配置完整指南
    • TikTok 数据抓取实战:基于 Python 的无认证方案
    • 蓝桥杯 C/C++ 组备考:C++ 基础知识(上)
    • Windows 使用 Codex 显示“正在思考”的代理配置与脚本方案
    • Ubuntu 下 llama.cpp 编译与性能调优实战
    • 耳机阻抗与前端适配:32Ω至 300Ω耳机的推力需求解析
    • Python 移动开发指南:使用 python-for-android 构建安卓应用
    • 零一万物发布 Yi-Large 评测超 GPT-4 李开复称十年不套现
    • OpenClaw gateway start 报 401 Invalid API key 环境变量配置问题
    • Python 2026 发展展望:AI 时代的通用基础设施语言
    • 高并发场景下 Java 与 Go 的区别及 Channel 机制详解
    • UniApp 结合 Python 开发跨平台房屋租赁系统
    • 基于 SpringBoot 与 Vue 的校园组团平台信息管理系统设计
    • OpenClaw 生态解析:AI 智能体如何重塑数字生活
    • 人工智能、机器学习与深度学习的关系解析
    • String 性能优化与内存节省实践
    • 大模型核心面试问题与解析:100 道高频考点梳理
    • PostgreSQL INSERT INTO 语句详解
    • 睿抗机器人大赛:ROS 机器人仿真环境搭建与任务控制

    相关免费在线工具

    • RSA密钥对生成器

      生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

    • Mermaid 预览与可视化编辑

      基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

    • 随机西班牙地址生成器

      随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

    • curl 转代码

      解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

    • Base64 字符串编码/解码

      将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

    • Base64 文件转换器

      将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online