Custom MCP Database

🚀 MCP Database Server

このプロジェクトは、Middleware/Control Plane (MCP) サーバーを提供します。このサーバーを使用すると、コードエージェント（Gemini、Claude Desktop、Claude Code など）が、資格情報を直接公開することなく、様々なデータベース（PostgreSQL、MySQL、MongoDB、Oracle）に対してクエリを安全に実行できます。データベース接続設定は、SQLite データベース (mcp_config.sqlite3) 内で管理されます。

🚀 クイックスタート

このプロジェクトをセットアップするには、以下の手順に従ってください。

📦 インストール

1. リポジトリをクローンする（まだクローンしていない場合）：

   git clone <repository_url>
   cd custom-mcp-database
   

2. 依存関係をインストールする： このプロジェクトでは、依存関係を管理するために venv（仮想環境）を使用しています。以下のコマンドを実行して、仮想環境を作成し、必要な Python パッケージをインストールします。

   make install
   

   これにより、venv/ ディレクトリが作成され、requirements.txt に記載されているすべてのパッケージがインストールされます。

💻 MCP サーバーの起動

MCP サーバーを起動するには、make run コマンドを使用します。

make run

サーバーが起動し、コードエージェントからの着信要求を待機します。

📚 データベースの設定

データベース接続は mcp_config.sqlite3 に保存されます。これらの接続は、グローバルな mcp-db コマンド（推奨）またはローカルの main.py スクリプトを使用して管理できます。

データベース接続の追加

add-db コマンドを使用します。必要なパラメータは、データベースの種類によって異なります。

一般的な構文（グローバルコマンド - 推奨）：

mcp-db add-db --alias <alias> --type <type> [connection_parameters]

代替（ローカルコマンド）：

python main.py add-db --alias <alias> --type <type> [connection_parameters]

サンプル（グローバルコマンド）：

• PostgreSQL:

  mcp-db add-db --alias pg_dev --type postgres --host localhost --port 5432 --user myuser --password mypassword --dbname mydb
  

• MySQL:

  mcp-db add-db --alias mysql_prod --type mysql --host 192.168.1.10 --port 3306 --user root --password secret --dbname production_db
  

• Oracle:

  mcp-db add-db --alias oracle_test --type oracle --host oracle.example.com --port 1521 --user system --password oraclepass --dbname ORCLPDB1
  

• MongoDB:

  mcp-db add-db --alias mongo_cluster --type mongo --uri "mongodb+srv://user:pass@cluster.mongodb.net/" --dbname myapp_db
  

データベース接続の削除

削除したい接続のエイリアスを指定して、remove-db コマンドを使用します。

グローバルコマンド:

mcp-db remove-db --alias <alias>

ローカルコマンド:

python main.py remove-db --alias <alias>

サンプル:

mcp-db remove-db --alias pg_dev

ヘルプの表示

詳細なヘルプとサンプルを表示するには、以下のコマンドを実行します。

mcp-db --help
mcp-db execute-query --help

💻 コードエージェントとの統合

Gemini

MCP サーバーが起動したら (make run)、Gemini は自動的にサーバーを検出し、構成されたデータベースとやり取りするための以下のツールを使用できるようになります。

• list_aliases(): 構成されたすべてのデータベースエイリアスをリストします。
• add_database(...): 新しいデータベース接続を追加します。
• remove_database(...): データベース接続を削除します。
• execute_query(database_alias, query, params, schema): 構成されたデータベースに対してクエリを実行します。

Gemini の使用例:

• エイリアスの一覧表示:

  list_aliases()
  

• SQL クエリの実行 (PostgreSQL/MySQL/Oracle):

  execute_query(database_alias="pg_dev", query="SELECT * FROM users WHERE id = %s;", params={"id": 1})
  

• MongoDB クエリの実行:

  execute_query(database_alias="mongo_cluster", query='''{"name": "John Doe"}''', params={"collection": "users"})
  

Claude Desktop

Claude Desktop と統合するには、claude_desktop_config.json ファイルを構成して、MCP サーバーを指すようにする必要があります。このファイル（通常は Claude Desktop の設定ディレクトリにあります）を作成または変更し、以下のようなエントリを追加します。

{
  "mcpServers": {
    "Custom DB Server": {
      "command": "/your-path-to/custom-mcp-database/venv/bin/python",
      "args": [
        "/your-path-to/custom-mcp-database/main.py"
      ],
      "workingDirectory": "/your-path-to/custom-mcp-database"
    }
  }
}

重要: /your-path-to/custom-mcp-database を、custom-mcp-database ディレクトリの実際の絶対パスに置き換えてください。

設定後、Claude Desktop を再起動します。すると、Claude Desktop 内で MCP ツールを使用できるようになります。

AI エージェントのツール設定

Claude Code や Gemini などの AI エージェントが MCP サーバーのツールを自動的に検出して利用できるようにするには、AI エージェントを構成して、MCP サーバーを起動または接続する必要があります。これには通常、main.py スクリプトへのパスを指定し、作業ディレクトリを指定する必要があります。

以下は、AI エージェントの mcpServers セクションを構成する例です。

Claude Code の場合

{
  "mcpServers": {
    "Custom DB Server": {
      "command": "/your-path-to/custom-mcp-database/venv/bin/python",
      "args": [
        "/your-path-to/custom-mcp-database/main.py"
      ],
      "workingDirectory": "/your-path-to/custom-mcp-database"
    }
  }
}

Gemini の場合

{
  "mcpServers": {
    "Custom DB Server": {
      "command": "/your-path-to/custom-mcp-database/venv/bin/python",
      "args": [
        "/your-path-to/custom-mcp-database/main.py"
      ],
      "workingDirectory": "/your-path-to/custom-mcp-database"
    }
  }
}

重要: /your-path-to/custom-mcp-database を、custom-mcp-database ディレクトリの実際の絶対パスに置き換えてください。

外部 MCP サーバーを構成するための最も正確かつ最新の手順については、使用する AI エージェントの公式ドキュメントを参照してください。