MCP-Python

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

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

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

前提条件

• Docker Compose (https://docs.docker.com/compose/install/)
• Claude Desktop (https://claude.ai/download)
• uv : 最新の高性能Pythonパッケージマネージャー。インストールされていない場合は、以下の手順に従ってください。

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 経由でデータベースとのやり取りを開始します。

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

楽しいコーディングを！