Claudeでまとめた!Windows 11 MCP サーバー完全ガイド

📝 前回の記事から続き

この記事は、「外国特許出願業務で生成AI Claudeを使い始めた話」の続編です。

前回は導入のきっかけや実際の使用感をお話ししましたが、今回はClaude(AI)に手伝ってもらいながら、具体的な設定方法をまとめました。

※ このガイドは、Claude Opus 4との対話を通じて作成されました。実際に私が試しながら、うまくいった手順をまとめています。

💻Claude Desktopの準備

1. Claude Desktopのインストール

  1. 公式サイトからダウンロード
  2. インストール
    • ダウンロードした.exeファイルを実行
    • 指示に従ってインストール

2. 設定ファイルを開く方法

方法A:Claude Desktop内から開く(簡単!)

  1. Claude Desktopを起動
  2. 右上の「⚙️」(設定)アイコンをクリック
  3. 「Developer」タブを選択
  4. 「Edit Config」ボタンをクリック
  5. メモ帳でclaude_desktop_config.jsonが開きます

方法B:エクスプローラーから開く

  1. Windowsキー + R を押す
  2. %APPDATA%\Claudeと入力してEnter
  3. claude_desktop_config.jsonをダブルクリック

📊比較表

項目 Pythonベース Node.jsベース
本質 プログラミング言語そのもの JavaScript実行環境
実際の言語 Python言語で記述 JavaScript言語で記述
ベースとなる言語 C言語で実装 C++で実装
得意分野 データ処理、AI、文書変換 Web操作、ファイル操作、API連携
起動速度 やや遅い 高速
代表例 markitdown-mcp、mcp-server-office filesystem、playwright

🐍Pythonベース

1. Pythonのインストール

  1. 公式サイトからダウンロード
  2. インストール時の設定
    • 「Add Python to PATH」に必ずチェック
    • 「Install Now」をクリック
  3. 確認コマンド

    💡 コマンドの入力方法
    ① Windowsキーを押して「cmd」と入力
    ② 「コマンドプロンプト」をクリック
    ③ 黒い画面に以下のコマンドを入力してEnter

    python --version
    pip --version

2. MCPサーバーのインストール

よく使われるPython系MCPサーバーの例:

※ 以下のコマンドはコマンドプロンプトに入力します

# markitdown-mcp: 様々なファイルをMarkdown形式に変換
pip install markitdown-mcp

# mcp-server-office: Word文書(.docx)の読み書き・編集
pip install mcp-server-office

3. Claude Desktopへの設定

%APPDATA%\Claude\claude_desktop_config.jsonに追加:

以下は markitdown-mcp と mcp-server-office をインストールした場合の例:

{
  "mcpServers": {
    "markitdown": {
      "command": "python",
      "args": ["-m", "markitdown_mcp"]
    },
    "office": {
      "command": "python", 
      "args": ["-m", "mcp_server_office"]
    }
  }
}

4. インストール済みの確認

# すべてのPythonパッケージ
pip list

# MCPサーバーのみ抽出
pip list | findstr mcp

5. アンインストール

pip uninstall markitdown-mcp
pip uninstall mcp-server-office

🌐Node.jsベース

1. Node.jsのインストール

  1. 公式サイトからダウンロード
  2. インストール
    • デフォルト設定でOK
    • 自動的にPATHに追加される
  3. 確認コマンド

    💡 コマンドの入力方法
    ① Windowsキーを押して「cmd」と入力
    ② 「コマンドプロンプト」をクリック
    ③ 黒い画面に以下のコマンドを入力してEnter

    node --version
    npm --version
    npx --version

2. MCPサーバーの設定(インストール不要)

Node.js系はnpxで直接実行するため、事前インストール不要

よく使われるNode.js系MCPサーバー:

  • filesystem: ローカルファイルの読み書き・操作
  • playwright: ブラウザの自動操作(Webサイトのスクレイピング等)

3. Claude Desktopへの設定

%APPDATA%\Claude\claude_desktop_config.jsonに追加:

以下は filesystem と playwright を使用する場合の例:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\YourName\\Desktop"
      ]
    },
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}

※ filesystemの場合、最後の引数にアクセスを許可するフォルダパスを指定します

⚠️ パスの区切り文字(¥または\)は必ず2つ重ねて記述してください
例:C:¥Users¥YourName¥Desktop → “C:¥¥Users¥¥YourName¥¥Desktop”
(環境によって¥または\で表示されますが、どちらも同じです)

4. インストール済みの確認

# グローバルインストールされたパッケージ
npm list -g --depth=0

# npxのキャッシュ確認
npx cache list

5. アンインストール(キャッシュクリア)

# npxのキャッシュをクリア
npx cache clean

📝統合例:両方を使う設定

以下は filesystem(Node.js系)と markitdown(Python系)を組み合わせた例:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:\\Users\\YourName\\Desktop"]
    },
    "markitdown": {
      "command": "python",
      "args": ["-m", "markitdown_mcp"]
    }
  }
}

※ パスの区切り文字(¥または\)は必ず2つ重ねて記述してください

クイックスタート

🔰 初心者の方へ
以下の「コマンド」は、コマンドプロンプト(黒い画面)に入力します。
開き方:Windowsキー → 「cmd」と入力 → コマンドプロンプトをクリック

Pythonベースを始める

# 1. Pythonインストール後
python --version

# 2. MCPサーバーインストール
pip install markitdown-mcp

# 3. 設定追加後、Claude Desktop再起動

Node.jsベースを始める

# 1. Node.jsインストール後
node --version

# 2. 設定追加(インストール不要)
# 3. Claude Desktop再起動

🔧トラブルシューティング

コマンドが認識されない場合

  1. 新しいコマンドプロンプトを開く
    • 既に開いているものではなく、必ず新しく開く
    • Windowsキー → 「cmd」→ Enter
  2. 環境変数を確認
    echo %PATH%

設定が反映されない場合

  1. JSONの構文を確認(カンマの位置)
  2. Claude Desktopを完全に終了して再起動

設定ファイルが見つからない場合

  1. Claude Desktopを一度起動する(初回起動で作成される)
  2. 手動で作成する場合
    • %APPDATA%\Claudeフォルダを開く
    • 新規テキストファイルを作成
    • claude_desktop_config.jsonに名前変更
    • 最低限の内容を記入:{"mcpServers": {}}

【本記事に関するご質問やご意見はお問い合わせフォームで承ります。なお、営業・勧誘目的のご連絡はご遠慮ください。】

この記事を書いた人

コメント

コメント一覧 (1件)

目次