Claude MCP Windows修复程序
修复了由于捆绑的macOS/Linux二进制文件而在Windows上发生故障的Claude Desktop MCP(模型上下文协议)服务器。
🎯 快速修复
以管理员身份运行PowerShell:
powershell -ExecutionPolicy Bypass -File fix-all-mcp-servers.ps1然后重新启动Claude Desktop。
📋 涉及的问题
| 问题 | 脚本 | 需要管理员 | 需要重新启动 |
|---|---|---|---|
| AWS API MCP服务器-macOS二进制文件 | fix-all-mcp-servers.ps1 | 否 | 否 |
| Zscaler MCP服务器-macOS二进制文件 | fix-all-mcp-servers.ps1 | 否 | 否 |
______________________________________________________________________
🔌 根本原因
AWS API MCP服务器和Zscaler MCP服务器捆绑Python包,其中包含为macOS/Linux构建的预编译二进制文件:
server/lib/
├── rpds/
│ └── rpds.cpython-311-darwin.so ← macOS binary, won't load on Windows
├── pydantic_core/
│ └── _pydantic_core.cpython-311-darwin.so
└── ... (many more)Windows需要 .pyd 二进制文件而不是 .so 文件夹。
🛠️ 解决方案
- 禁用捆绑包 使用特定于平台的二进制文件
- 安装Windows本机版本 通过pip
- 重新启动克劳德桌面
需要Windows二进制文件的软件包
rpds-py-Rust持久数据结构pydantic-core-锈芯orjson-快速JSON(Rust)jiter-JSON迭代器charset-normalizer-字符编码markupsafe-HTML转义PyYAML-YAML解析器websockets-WebSocket库zstandard-Zstd压缩cffi-C外部功能接口cryptography-加密操作
______________________________________________________________________
📁 存储库结构
claude-mcp-windows-fixes/
├── README.md
├── LICENSE
├── fix-all-mcp-servers.ps1 # Main MCP fix script
├── issues/
│ ├── aws-api-mcp-server.md # AWS issue documentation
│ └── zscaler-mcp-server.md # Zscaler issue documentation
└── scripts/
├── fix-all-mcp-servers.ps1 # MCP server fixes
└── fix-zscaler-mcp-windows.ps1 # Standalone Zscaler fix⚠️ 上游问题
- 遮阳板/MCP -AWS API MCP服务器Windows兼容性
- zscaler/zscaler mcp服务器 -Zscaler MCP服务器与Windows的兼容性
📝 许可证
MIT许可证-请参阅 许可证
🤝 贡献
- 克隆该仓库
- 创建功能分支
- 提交您的更改
- 推到分支
- 创建拉取请求
