AI导哈

Claude MCP Windows修复工具

修复Claude桌面版MCP服务器在Windows上因捆绑macOS/Linux二进制文件而失败的问题。

  • by Galtman117
  • PowerShell
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Galtman117/claude-mcp-windows-fixes

使用说明

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 文件夹。

🛠️ 解决方案

  1. 禁用捆绑包 使用特定于平台的二进制文件
  2. 安装Windows本机版本 通过pip
  3. 重新启动克劳德桌面

需要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

⚠️ 上游问题

📝 许可证

MIT许可证-请参阅 许可证

🤝 贡献

  1. 克隆该仓库
  2. 创建功能分支
  3. 提交您的更改
  4. 推到分支
  5. 创建拉取请求

相关 MCP