Windows MCP 服务器安装验证指南

与 macOS 不同，Windows 上的 MCP 服务器设置需要绝对文件路径，并且需要显式引用 node.exe 而不是使用 npx 命令。安装过程需要验证 npm 并全局安装到 AppData\Roaming\npm\node_modules 目录。运行服务器时需要提供 node.exe 和服务器的 index.js 文件的完整路径。

README.md 文件目前存在，脚本稍后提供...

=-=-=-=-=-

本指南假设您已经在 Windows 10 上进行了基本的 MCP 安装。该指南由运行 MCP 服务器的 Claude 桌面应用程序创建。

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