MCP を使用してデータベースと対話する

このガイドでは、Claude Desktopを使用してPostgreSQLデータベースと連携するためのMCPサーバーの設定と実行方法について説明します。内部でsqlalchemyを使用しているため、MySQL、MariaDB、SQLiteでも動作します。このプロジェクトはhttps://github.com/runekaagaard/mcp-alchemyをベースに構築されています。

**注:**このガイドでは、Docker、環境変数、および CLI の使用に関する基本的な知識があることを前提としています。

前提条件

• Docker Compose :インストール手順

• Claude Desktop :ここからダウンロード

• uv : 最新の高性能Pythonパッケージマネージャー。インストールされていない場合は、以下の手順に従ってください。

Related MCP server: MCP Database Server

1. 環境変数を設定する

1. 環境ファイルのコピーと名前の変更
   提供されている.env.exampleファイルを複製し、名前を.envに変更します。

   cp .env.example .env

2. Claudeデスクトップをセットアップする

1. Claude Desktop をダウンロードしてインストールする
   Claude Desktop のダウンロード ページにアクセスして、アプリケーションをインストールします。

3. ダミーデータでPostgreSQLデータベースを起動する

1. Docker Composeを実行する
   Docker Compose がインストールされ、実行されていることを確認します。

   docker-compose up -d

   • このコマンドはlocalhost:5432で PostgreSQL データベースを起動し、ダミー データを入力します。

4. uvをインストールする（まだインストールされていない場合）

1. uvをインストールする
   uvをインストールするには、次のコマンドを実行します。

   curl -LsSf https://astral.sh/uv/install.sh | sh

5. MCPサーバーの設定と起動

1. MCP サーバー構成の作成/更新
   次の JSON 構成を MCP サーバー構成ファイルに保存します (必要に応じてパスを調整します)。

   {
     "mcpServers": {
       "my_database": {
         "command": "uv",
         "args": [
           "--directory",
           "/directory/where/this/app/is/located/app/",
           "run",
           "server.py"
         ],
         "env": {
           "DB_URL": "postgresql://postgres:password@localhost:5432/mydatabase"
         }
       }
     }
   }

   • ヒント: uv標準以外の場所にインストールされている場合は、実行可能ファイルへの完全なパスを反映するように"command"値を更新します。

2. MCPサーバーを起動する
   設定が完了すると、Claude Desktop が起動されるたびに MCP サーバーが自動的に起動します。

6. セットアップを楽しむ

• Claude Desktopを開きます。

• このツールは自動的に MCP サーバーを呼び出し、データベースとシームレスに対話できるようにします。

まとめ

1. 環境変数を設定する: .env.exampleを.envにコピーします。

2. Claude Desktop をインストールして実行します。Claude Desktopからダウンロードします。

3. Docker Compose を使用して PostgreSQL を起動します。docker docker-compose upを実行して、ダミー データでデータベースを起動します。

4. uvをインストールします。必要に応じて、提供されているインストール コマンドを実行します。

5. MCP サーバーを構成する: 構成ファイルを更新し、パスと環境変数が正しいことを確認します。

6. 起動して楽しむ: Claude Desktop を起動して、MCP 経由でデータベースとのやり取りを開始します。

問題が発生した場合やさらにサポートが必要な場合は、関連ドキュメントを参照するか、サポート チームにお問い合わせください。

楽しいコーディングを！