实战踩坑记录从零开始在 Windows Claude Code 环境下成功配置 chatExcel-MCP遇到了 6 个真实问题并一一解决。Windows 11Claude CodePython 3.126 个坑全踩过目录背景为什么要配置这个坑 1pip 命令找不到坑 2Python 3.14 太新包不兼容坑 3requirements.txt 编码错误坑 4依赖版本冲突坑 5MCP 连接失败print 污染 stdout最终成功31 个工具全部加载00背景chatExcel-MCP是一个基于 MCP 协议的 Excel 智能处理服务器提供 31 个工具支持 Excel 读写、数据分析、图表生成、公式解析等功能。配合 Claude Code 使用后可以用自然语言直接操作 Excel 文件。本文记录了在 Windows 环境下从克隆项目到成功连接的全过程以及遇到的每一个问题和解决方法。01坑 1pip 命令找不到报错pip : 无法将pip项识别为 cmdlet、函数、脚本文件或可运行程序的名称。原因分析Python 安装路径下python.exe加入了系统 PATH但pip.exe所在的Scripts\目录没有加入。两者目录不同。解决方案用python -m pip代替pip让 Python 直接调用内置的 pip 模块绕过路径问题。# ❌ 报错 pip install -r requirements.txt # ✅ 正确 python -m pip install -r requirements.txt powershell02坑 2Python 3.14 太新包不兼容报错ERROR: Could not find a version that satisfies the requirement pandas2.2.3 (from versions: 2.3.3, 3.0.0...)原因分析Python 3.14 是最新版本很多库pandas、scipy 等还没有发布对应的预编译包wheel。pip 找不到兼容版本只能从源码编译而源码编译又需要 Fortran 编译器Windows 上默认没有。解决方案安装 Python 3.12这是目前兼容性最好的版本。Windows 支持多版本共存用py -3.12指定版本即可不用卸载 3.14。# 下载 Python 3.12 安装时务必勾选 ☑ Add Python to PATH # 验证安装 py -3.12 --version # Python 3.12.7 # 后续所有命令用 py -3.12 前缀 py -3.12 -m pip install -r requirements.txt powershell03坑 3requirements.txt 编码错误报错UnicodeDecodeError: gbk codec cant decode byte 0xae in position 39原因分析requirements.txt 文件包含中文注释保存为 UTF-8 编码。但 Windows 的 pip 默认用 GBK/CP936 读取文件遇到 UTF-8 特有字节就报错。解决方案用 PowerShell 强制以 UTF-8 读取再重新保存生成新文件后安装。# 转换编码生成新文件 Get-Content requirements.txt -Encoding UTF8 | Set-Content requirements_utf8.txt -Encoding UTF8 # 用新文件安装 py -3.12 -m pip install -r requirements_utf8.txt powershell04坑 4依赖版本冲突报错ERROR: Cannot install pydantic-settings2.7.0 and pydantic-settings2.9.1 because these package versions have conflicting dependencies.原因分析这个项目的 requirements.txt 写得很乱同一个包pydantic-settings在文件不同位置出现了两次而且版本号不同。这是项目本身的问题不是环境问题。解决方案跳过这个混乱的 requirements.txt只手动安装真正需要的核心包。原则只装运行时必须的包去掉测试工具、监控工具、可选功能等开发专用包。# 直接安装核心依赖跳过冲突 py -3.12 -m pip install fastmcp mcp pandas openpyxl xlsxwriter numpy matplotlib seaborn plotly chardet scipy tabulate formulas pydantic-settings python-dotenv loguru psutil rich requests httpx uvicorn pydantic pyyaml powershell05坑 5MCP 连接失败最难的一个报错chatExcel: ... ✗ Failed to connect直接运行 server.py 完全正常但 claude mcp list 就是连不上原因分析MCP 协议通过stdout标准输出传递 JSON 消息。server.py 里所有的print()语句比如✓ 成功导入模块这些提示也输出到了 stdout把 JSON 消息污染了。Claude Code 收到一堆夹杂着 emoji 的文本无法解析 MCP 协议所以连接失败。解决方案在 server.py 顶部添加几行代码将所有print()输出重定向到 stderr保持 stdout 干净只传 JSON。# 用 PowerShell 在文件顶部插入重定向代码 $content Get-Content ...\server.py -Encoding UTF8 -Raw $insert import sysnimport builtinsn_orig_print builtins.printnbuiltins.print lambda *a, **k: _orig_print(*a, filesys.stderr, **k)nn $new $insert $content Set-Content ...\server.py -Value $new -Encoding UTF8 powershell核心原理MCP 是基于 stdio 的协议stdout 是信道只能传 JSONstderr 是日志可以随便写。所有调试输出必须走 stderr。06最终成功31 个工具全部加载 # 验证连接 claude mcp list chatExcel: ... ✓ Connected # 启动 Claude Code claude powershell启动后Claude Code 已经可以识别全部 31 个 chatExcel 工具直接用自然语言操作 Excel# 示例用法 帮我分析 C:\Users\xxx\Desktop\销售数据.xlsx找出每月业绩趋势 把这个 Excel 的数据生成一个交互式折线图 清洗数据删除空白行并按日期排序 claude code6 个坑6 个经验有问题欢迎评论区交流特别是 MCP stdout 污染这个坑很多人都会踩到。