AI导哈

MCP服务器安装验证工具

一个用于验证Windows系统上MCP服务器安装状态的工具，提供详细的安装检查步骤和故障排除指南。

  • by trevorwilkerson
  • 本地部署
  • 19 星标
  • 更新于
在 GitHub 查看 trevorwilkerson/Windows-MCP-Server-Installation-Verification-Guide

使用说明

Windows MCP服务器安装验证指南

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\<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. 查找成功消息：“顺序思维MCP服务器在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. 使用 node.exe 路径从 where node 命令
  5. 如果访问被拒绝，请检查权限

本指南可确保对Windows上的MCP服务器安装进行有条不紊、彻底的验证。按顺序执行每个步骤，并在进入下一步之前验证成功。

=-=-=-=-

MacOS和Windows 10在MCP服务器设置和安装方面的主要区别。

基于此分析，以下是针对MCP服务器设置的MacOS和Windows 10之间的全面比较指南：

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

文件系统结构

MacOS

  • 全球套餐： /usr/local/lib/node_modules
  • 节点可执行文件： /usr/local/bin/node
  • 配置位置： ~/Library/Application Support/Claude/
  • 使用正斜杠（/）
  • 默认情况下区分大小写

Windows 10

  • 全球套餐： C:\Users\<Username>\AppData\Roaming\npm
  • 节点可执行文件： 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：需要直接执行节点

  3. 权限

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

  4. 环境变量

    • MacOS： $HOME, $PATH 带结肠分离器
    • 窗户： %USERPROFILE%, %PATH% 带分号分隔符

  5. 配置要求

    • MacOS：更简单，依赖于npm/npx
    • Windows：更详细，需要完整路径

平台间转换

  1. 路径转换

    • MacOS到Windows：替换 / 随着 \\
    • 添加驱动器号（例如。， C:)开始时
    • 替换 /usr/local 具有适当的Windows路径

  2. 命令转换

    • 替换 npx 直接命令 node.exe 执行
    • 将环境变量转换为Windows格式
    • 删除Unix特定权限命令

  3. 配置转换

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

常见问题及解决方法

  1. Windows特定

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

  2. 转换陷阱

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

相关 MCP