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 Desktop 应用程序创建。

完整的 Windows MCP 服务器安装验证指南

我将使用顺序思维来分析和创建一个全面的 MCP 顺序思维服务器指南。

基于此分析，以下是验证 Windows 上 MCP 服务器安装的完整指南：

前提条件检查

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

   npm --version
   

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

   npm config get prefix
   

   注意：应指向 C:\Users\<您的用户名>\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 前缀：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 vs Windows 10：MCP 服务器设置差异

文件系统结构

MacOS

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

Windows 10

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

命令执行

MacOS

# 软件包执行
npx @modelcontextprotocol/server-sequential-thinking

# 全局安装
sudo npm install -g @package-name

# 权限设置
chmod +x ./script.sh

Windows 10

# 软件包执行
node "C:\Users\Username\AppData\Roaming\npm\node_modules\@package-name\dist\index.js"

# 全局安装（以管理员身份）
npm install -g @package-name

# 权限设置
# 以管理员身份运行 CMD

配置文件格式

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 引用
   • 不完整的路径转换
   • 权限模型不匹配