Windows-MCP-Server-Installation-Verification-Guide

Windows-MCP-Server-Installation-Verification-Guide

Windows 上的 MCP 服务设置与 Mac 不同：需要使用绝对文件路径并明确指定 node.exe，而不是使用 npx 命令。安装时需要验证 npm，并将软件包全局安装到 AppData\Roaming\npm\node_modules 目录。运行服务需要提供 node.exe 和服务的 index.js 文件的完整路径。

目前先提供 README.md 文件，脚本稍后推出……

=-=-=-=-=-

本指南假设你已在 Windows 10 上完成基本的 MCP 安装。本指南由运行 MCP 服务的 Claude 桌面应用创建。

Windows MCP 服务安装验证综合指南

我将使用顺序思维来分析并编写一份关于 MCP sequential-thinking 服务的综合指南。

根据上述分析，以下是验证 MCP 服务在 Windows 上是否安装的综合指南：

先决条件检查

1. 以管理员身份打开命令提示符
2. 验证 npm 是否已安装：

   npm --version
   

3. 检查 npm 的全局安装目录：

   npm config get prefix
   

   注意：路径应为 C:\Users\<YourUsername>\AppData\Roaming\npm

安装状态检查

1. 检查软件包是否已安装：

   npm list -g @modelcontextprotocol/server-sequential-thinking
   

2. 查找 Node.js 可执行文件：

   where node
   

   注意：通常位于 C:\Program Files\nodejs\node.exe

软件包安装

1. 如果尚未安装，请运行：

   npm install -g @modelcontextprotocol/server-sequential-thinking
   

2. 验证是否安装成功：

   npm list -g @modelcontextprotocol/server-sequential-thinking
   

目录结构验证

1. 前往 npm 模块目录：

   cd %APPDATA%\npm\node_modules\@modelcontextprotocol
   

2. 验证文件夹结构：

   dir
   cd server-sequential-thinking
   dir
   cd dist
   dir
   

   预期结构：
   • @modelcontextprotocol\
     • server-sequential-thinking\
       • dist\
         • index.js

执行测试

1. 使用绝对路径运行服务：

   node "%APPDATA%\npm\node_modules\@modelcontextprotocol\server-sequential-thinking\dist\index.js"
   

2. 查看成功消息：“Sequential Thinking MCP Server running on stdio”

故障排除指南

1. 如果 npm config get prefix 显示的位置不符合预期：

   • 重置 npm prefix：npm config set prefix "%APPDATA%\npm"

2. 如果出现 MODULE_NOT_FOUND 错误：

   • 验证安装：npm install -g @modelcontextprotocol/server-sequential-thinking
   • 检查文件路径是否完全匹配

3. 如果找不到 node.exe：

   • 验证 Node.js 是否已安装
   • 如有需要，将其添加到 PATH

4. 如果目录结构不完整：

   • 卸载软件包：npm uninstall -g @modelcontextprotocol/server-sequential-thinking
   • 清除 npm 缓存：npm cache clean --force
   • 重新安装软件包

Windows 特定注意事项

1. 在配置文件中始终使用双反斜杠（\）
2. 使用绝对路径，而非相对路径
3. 注意 Windows 的路径长度限制
4. 使用 where node 命令获取 node.exe 路径
5. 如果访问被拒绝，请检查权限

本指南可帮助你有条理、全面地验证 Windows 上的 MCP 服务安装。请按顺序完成每个步骤，并在进入下一步之前确认成功。

=-=-=-=-

MacOS 与 Windows 10 在 MCP 服务设置和安装方面的主要差异。

根据上述分析，以下是 MacOS 与 Windows 10 在 MCP 服务设置方面的综合对比指南：

MacOS 与 Windows 10：MCP 服务设置差异

文件系统结构

MacOS

• 全局软件包：/usr/local/lib/node_modules
• Node 可执行文件：/usr/local/bin/node
• 配置位置：~/Library/Application Support/Claude/
• 使用正斜杠（/）
• 默认区分大小写

Windows 10

• 全局软件包：C:\Users\<Username>\AppData\Roaming\npm
• Node 可执行文件：C:\Program Files\nodejs\node.exe
• 配置位置：%APPDATA%\Claude\
• 使用反斜杠（\）
• 不区分大小写

命令执行

MacOS

# Package execution
npx @modelcontextprotocol/server-sequential-thinking

# Global installation
sudo npm install -g @package-name

# Permission setting
chmod +x ./script.sh

Windows 10

# Package execution
node "C:\Users\Username\AppData\Roaming\npm\node_modules\@package-name\dist\index.js"

# Global installation (as Administrator)
npm install -g @package-name

# Permission setting
# Run CMD as Administrator

配置文件格式

MacOS

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    }
  }
}

Windows 10

{
  "mcpServers": {
    "sequential-thinking": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Users\\Username\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-sequential-thinking\\dist\\index.js"
      ]
    }
  }
}

关键差异总结

1. 路径处理

   • MacOS：使用 PATH 解析和相对路径
   • Windows：需要绝对路径并显式引用 node.exe

2. 包管理

   • MacOS：使用 npx 执行
   • Windows：需要直接运行 node

3. 权限

   • MacOS：使用 sudo 和 chmod
   • Windows：需要管理员权限

4. 环境变量

   • MacOS：使用 $HOME、$PATH，以冒号分隔
   • Windows：使用 %USERPROFILE%、%PATH%，以分号分隔

5. 配置要求

   • MacOS：更简单，依赖 npm/npx
   • Windows：更冗长，需要完整路径

跨平台转换

1. 路径转换

   • 从 MacOS 转换到 Windows：将 / 替换为 \\
   • 在开头添加驱动器号（例如 C:）
   • 将 /usr/local 替换为相应的 Windows 路径

2. 命令转换

   • 将 npx 命令替换为直接执行 node.exe
   • 将环境变量转换为 Windows 格式
   • 移除 Unix 专用的权限命令

3. 配置转换

   • 将 npx 命令替换为完整的 Windows 路径
   • 在 Windows 中移除 -y 标志
   • 添加 node.exe 的完整路径
   • 在路径中使用双反斜杠

常见问题和解决方案

1. Windows 特有问题

   • 路径长度限制
   • AppData 权限问题
   • JSON 中的反斜杠转义
   • CMD 与 PowerShell 的语法差异

2. 转换陷阱

   • 缺少路径分隔符
   • node.exe 引用不正确
   • 路径转换不完整
   • 权限模型不匹配