Model Context Protocol (MCP) Windows セットアップガイド

はじめに

MCPを使用すると、Claude Desktopがローカルのデータベースやファイルシステムなどのリソースに安全にアクセスできるようになります。このガイドでは、Windows環境でのMCPの設定方法を説明します。

ClaudeのAIエージェント『MCP』使ってローカルのデータベースに接続してみた！ https://t.co/bT1ISEUndv pic.twitter.com/kipKmEHARI

— Maki@Sunwood AI Labs. (@hAru_mAki_ch) November 26, 2024

前提条件

以下のソフトウェアが必要です：

1. Claude Desktop アプリ（最新版）
2. uv 0.4.18以上
3. Git
4. SQLite

インストール方法

wingetを使用する場合：

winget install --id=astral-sh.uv -e
winget install git.git sqlite.sqlite

または、各ソフトウェアを個別にダウンロード：

• uv: https://docs.astral.sh/uv/
• Git: https://git-scm.com
• SQLite: https://www.sqlite.org/download.html

セットアップ手順

1. テスト用データベースの作成

以下のSQLコマンドでテストデータベースを作成します：

sqlite3 ~/test.db
CREATE TABLE products (
  id INTEGER PRIMARY KEY,
  name TEXT,
  price REAL
);

INSERT INTO products (name, price) VALUES
  ('Widget', 19.99),
  ('Gadget', 29.99),
  ('Gizmo', 39.99),
  ('スマートウォッチ', 199.99),
  ('ワイヤレスイヤホン', 89.99),
  ('モバイルバッテリー', 24.99)
  -- 必要に応じて商品を追加

2. Claude Desktopの設定

1. 設定ファイルを作成：

• 場所: %APPDATA%\Claude\claude_desktop_config.json
• 以下の内容を追加（ユーザー名は変更してください）：

{
  "mcpServers": {
    "sqlite": {
      "command": "uvx",
      "args": ["mcp-server-sqlite", "--db-path", "C:/Users/YOUR_USERNAME/test.db"]
    }
  }
}

1. Claude Desktopを再起動

3. 動作確認

Claude Desktopで以下のようなプロンプトを試してみましょう：

SQLiteデータベースに接続して、どんな商品が登録されていて、それぞれの価格を教えてください。

追加機能の設定

ファイルシステムへのアクセスを追加する場合：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "C:/Users/YOUR_USERNAME/Desktop"]
    }
  }
}

PostgreSQLデータベースに接続する場合：

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

トラブルシューティング

問題が発生した場合は、以下を確認してください：

1. MCPが有効になっているか

   • Claude Desktopの🔌アイコンをクリック
   • 「Installed MCP Servers」を展開
   • 設定したサーバーが表示されているか確認

2. 設定の確認

   • Claude Desktop > 設定 > Developer タブ
   • 設定内容が正しいか確認

3. よくある問題の解決策

   • ファイルパスが正しいか確認
   • データベースファイルのアクセス権限を確認
   • SQLiteが正しくインストールされているか確認

サンプルプロンプト

1. 基本的なクエリ：

データベースの商品の平均価格を教えてください。

1. データ分析：

商品の価格分布を分析して、価格設定の最適化について提案してください。

1. より複雑な操作：

顧客の注文を保存するための新しいテーブルの設計を手伝ってもらえますか？

セキュリティについて

• MCPサーバーは特定の機能のみを公開
• サーバーはローカルで動作し、外部にリソースを公開しない
• 機密性の高い操作にはユーザーの確認が必要

このガイドに従えば、Claude Desktopとローカルリソースを安全に接続できるはずです。もし質問や問題がありましたら、お気軽にお申し付けください。

参考サイト