Postgresql Alchemy

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

MCPを使用して、Claude Desktop経由でPostgreSQLデータベースと対話する方法を説明します。MySQL、MariaDB、SQLiteにも対応しています。

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

⚠️ 重要提示

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

🚀 クイックスタート

📋 前提条件

• Docker Compose： インストール手順
• Claude Desktop：こちらからダウンロード
• uv：最新の高性能Pythonパッケージマネージャー。未インストールの場合は、以下の手順に従ってください。

⚙️ セットアップ手順

1. 環境変数の設定

1. 環境ファイルのコピーとリネーム
   提供されている.env.exampleファイルをコピーして、.envにリネームします。

   cp .env.example .env
   

2. Claude Desktopの設定

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

3. DummyデータでPostgreSQLデータベースを起動

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

   docker-compose up -d
   

   • このコマンドにより、localhost:5432でPostgreSQLデータベースが起動し、Dummyデータが挿入されます。

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-compose upを実行して、Dummyデータ付きのデータベースを起動します。
4. uvのインストール：必要に応じて、提供されたインストールコマンドを実行します。
5. MCPサーバーの設定：設定ファイルを更新し、パスと環境変数が正しいことを確認します。
6. 起動して楽しむ：Claude Desktopを起動して、MCPを介してデータベースとの対話を開始します。

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

Happy coding!