Claude MCP Get

一个用于在 Windows 系统上安装和配置带有 Claude Desktop 的模型上下文协议 (MCP) 服务器的综合工具包。

概述

此存储库包含脚本、配置和文档，旨在帮助 Windows 用户成功安装和使用带有 Claude Desktop 的模型上下文协议 (MCP) 服务器。它侧重于克服阻止 Windows 上 MCP 连接的常见问题，特别是 npx 命令、路径解析和多个 Node.js 安装的问题。

主要特性

• 用于识别 Node.js 安装的诊断工具
• 避免常见陷阱的安装脚本
• 带有绝对路径的配置模板
• 用于解决“无法连接到 MCP 服务器”错误的故障排除指南
• 针对 NVM 和 Node.js 路径问题的解决方案

快速开始

1. 克隆此存储库
2. 运行 find-nodejs.bat 以识别您的 Node.js 安装
3. 如果您有多个安装，请运行 cleanup-nodejs.bat
4. 运行 install-mcp.bat 以安装您选择的 MCP 服务器
5. 按照显示的配置说明进行操作

常见的 Windows 问题和解决方案

NPX 连接失败

Windows 上最常见的问题是，当在 claude_desktop_config.json 中使用 npx 命令时，MCP 服务器无法连接。这是由于 Claude Desktop 在 Windows 上启动子进程的方式造成的。

解决方案： 使用带有绝对路径的直接 node 执行，例如：

{
  "mcpServers": {
    "server-name": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Users\\Username\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-name\\dist\\index.js",
        "parameter1", "parameter2"
      ],
      "env": {
        "APPDATA": "C:\\Users\\Username\\AppData\\Roaming\\",
        "PATH": "C:\\Program Files\\nodejs",
        "NODE_PATH": "C:\\Users\\Username\\AppData\\Roaming\\npm\\node_modules"
      }
    }
  }
}

多个 Node.js 安装

拥有多个 Node.js 安装（尤其是使用 NVM）会导致路径解析问题。

解决方案： 使用默认位置的标准 Node.js 安装，并指定绝对路径。

需要重启任务管理器

仅仅关闭并重新打开 Claude Desktop 通常无法完全重新加载配置。

解决方案： 在重新启动之前，结束任务管理器中的所有 Claude Desktop 进程。

文档

• 安装指南
• 故障排除指南
• MCP 服务器参考
• 配置模板

脚本

• find-nodejs.bat - 识别系统上的所有 Node.js 安装
• cleanup-nodejs.bat - 清理 npm 缓存并修复常见的安装问题
• install-mcp.bat - 使用正确的路径全局安装 MCP 服务器
• run-server.bat - 运行 MCP 服务器以在 Claude Desktop 之外进行测试

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT 许可证

致谢

• 模型上下文协议 团队
• MCP 服务器 GitHub 问题 #40 的贡献者