Windows-MCP-Server-Installation-Verification-Guide

Windows-MCP-Server-Installation-Verification-Guide

Windows での MCP サーバーのセットアップは、npx コマンドの代わりに絶対ファイルパスと明示的な node.exe の指定が必要な点で、Mac と異なります。インストール時には npm を確認し、パッケージを AppData\Roaming\npm\node_modules ディレクトリにグローバルインストールする必要があります。サーバーを実行するには、node.exe とサーバーの index.js ファイルの両方について完全なパスを指定する必要があります。

現在は README.md ファイルのみです。スクリプトは後日追加予定です……

=-=-=-=-=-

このガイドは、Windows 10 で基本的な MCP のインストールを実施済みであることを前提としています。このガイドは、MCP サーバーを実行する Claude Desktop アプリで作成されました。

Windows MCP サーバーの包括的なインストール確認ガイド

MCP sequential-thinking サーバーについて分析し、包括的なガイドを作成するために、順を追って考えていきます。

この分析に基づき、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. 成功メッセージ「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 つ（\）使用します
2. 相対パスではなく絶対パスを使用します
3. Windows のパス長制限に注意します
4. where node コマンドで確認した node.exe のパスを使用します
5. アクセスが拒否された場合は、アクセス許可を確認します

このガイドでは、Windows での MCP サーバーのインストールを、体系的かつ徹底的に確認できます。各手順を順番に実行し、次の手順に進む前に成功したことを確認してください。

=-=-=-=-

MCP サーバーのセットアップとインストールにおける、MacOS と Windows 10 の主な違いです。

この分析に基づき、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 の参照先の誤り
   • 不完全なパス変換
   • 権限モデルの不一致