DB Query MCP

[ English | 中文 ]

db-query-mcp

はじめに

db-query-mcpは、多様なデータベースのクエリとエクスポートに対応したMCPツールです。次の機能を備えています。

• マルチDB対応：主要なデータベース（ElasticSearch、MySQL、PostgreSQL、Oracle、SQLiteなど）と完全な互換性があります
• 安全なアクセス：データ保護のため、デフォルトで読み取り専用モードになっています
• スマートクエリ：自然言語からSQLへの変換とクエリの最適化に対応しています
• データのエクスポート：CSV／Json形式でエクスポートできます
• ロードマップ：MongoDBとGraphDatabaseへの対応を拡大し、フルスタックのDBクエリMCPを目指しています

デモ

https://github.com/user-attachments/assets/60771cda-8b52-41bd-90e3-523c836f6366

変更履歴

• 2025-06-02：ElasticSearchデータベースのクエリに対応しました

インストール

pip install db-query-mcp

ElasticSearch：

pip install "db-query-mcp[elasticsearch]"

GitHubからインストール：

pip install git+https://github.com/NewToolAI/db-query-mcp

MySQLには追加の依存関係が必要です：

pip install pymysql

PostgreSQLには追加の依存関係が必要です：

pip install psycopg2-binary

その他のデータベースでは、それぞれの接続パッケージをインストールしてください：

データベース	接続パッケージ	接続文字列の例
SQLite	Python組み込み	sqlite:///example.db
MySQL	pymysql または mysql-connector-python	mysql+pymysql://user:password@localhost/dbname
PostgreSQL	psycopg2 または psycopg2-binary	postgresql://user:password@localhost:5432/dbname
Oracle	cx_Oracle	oracle+cx_oracle://user:password@hostname:1521/sidname
SQL Server	pyodbc または pymssql	mssql+pyodbc://user:password@hostname/dbname

設定

注：Cursorなど一部のクライアントでは、db-query-mcpサーバーを同時に1つしか実行できません。

uvxを使って実行

{
  "mcpServers": {
      "sqlite_db_mcp": {
        "command": "uvx",
        "args": [
          "db-query-mcp",
          "--db",
          "sqlite",
          "--uri", 
          "sqlite:///sqlite_company.db"
        ]
      }
  }
}

{
  "mcpServers": {
      "es_db_mcp": {
        "command": "uvx",
        "args": [
          "db-query-mcp",
          "--db",
          "elasticsearch",
          "--uri", 
          "https://user:password@localhost:9200?index=test_data_index&ca_certs=/home/user/http_ca.crt"
        ]
      }
  }
}

コマンドを使って実行

{
  "mcpServers": {
      "sqlite_db_mcp": {
        "command": "db-query-mcp",
        "args": [
          "--db",
          "sqlite",
          "--uri", 
          "sqlite:///sqlite_company.db"
        ]
      }
  }
}

{
  "mcpServers": {
      "es_db_mcp": {
        "command": "db-query-mcp",
        "args": [
          "--db",
          "elasticsearch",
          "--uri", 
          "https://user:password@localhost:9200?index=test_data_index&ca_certs=/home/user/http_ca.crt"
        ]
      }
  }
}