Sql MCP

🚀 SQL MCP Server

SQL MCP Server は、AIモデル（Claudeなど）が、単一の標準化されたツールセットを通じて、複数の種類のデータベースを調査、クエリ実行、および相互作用することを可能にする統一されたエージェントインターフェイスです。

MySQL、SQL Server、Oracleなどの個別のサーバーをインストールおよび構成する代わりに、この単一のパッケージは、設定に基づいて正しい「アダプター」を動的にロードすることで、すべてのデータベースを処理します。

✨ 主な機能

• 標準化されたツールセット：AIは、Oracleとやり取りしている場合でもMySQLとやり取りしている場合でも、常に同じツール（execute_query、describe_table、get_db_version）を見ることができます。これにより、誤った情報の生成を減らし、クエリの精度を向上させます。
• リソース：データベースのテーブルをMCPリソースとして自動的に公開し、簡単に調査できるようにします。
• スマートアダプター：
  • ✅ MySQL：コネクションプーリングを使用した mysql-connector-python を使用します。
  • ✅ MSSQL：pymssql を使用し、スキーマ名（例：dbo.Users）を自動検出します。
  • ✅ Sybase / SAP IQ：pyodbc を使用し、dba. 接頭辞とサーバー名を適切に処理します。
  • ✅ Oracle：複雑なドライバーのインストールなしで簡単に接続できる oracledb（Thinモード）を使用します。
• Unicode対応：すべての接続はデフォルトでUTF - 8に設定されており、特殊文字を問題なく処理できます。

📦 インストール

1. リポジトリをクローンする：

   git clone https://github.com/BryR0/sql-mcp.git
   cd sql-mcp
   

2. 仮想環境を作成する：

   python -m venv venv
   source venv/bin/activate  # Windowsの場合: .\venv\Scripts\activate
   

3. 依存関係をインストールする：

   pip install -e .
   

🔧 設定

DB_TYPE 環境変数を使用して、使用するデータベースを定義します。

サポートされる環境変数

Claude Desktopの設定例

これを claude_desktop_config.json に追加してください。DB_PORT はオプションで、省略した場合、選択したデータベースの標準ポートがデフォルトとなります。

{
  "mcpServers": {
    "sql_mcp_mysql": {
      "command": "C:\\path\\to\\venv\\python.exe",
      "args": ["-m", "sql_mcp"],
      "env": {
        "DB_TYPE": "mysql",
        "DB_HOST": "localhost",
        "DB_USER": "root",
        "DB_PASSWORD": "password",
        "DB_DATABASE": "my_db"
      }
    },
    "sql_mcp_mssql": {
      "command": "C:\\path\\to\\venv\\python.exe",
      "args": ["-m", "sql_mcp"],
      "env": {
        "DB_TYPE": "mssql",
        "DB_HOST": "192.168.1.50",
        "DB_USER": "sa",
        "DB_PASSWORD": "password",
        "DB_DATABASE": "DataWarehouse"
      }
    }
  }
}

🏗️ アーキテクチャ

このプロジェクトはアダプターパターンを使用しています。

1. サーバーがリクエスト（例：execute_query）を受け取ります。
2. ファクトリーが DB_TYPE をチェックし、正しいクラス（例：MSSQLAdapter）をインスタンス化します。
3. アダプターが汎用的なリクエストを特定のドライバー呼び出し（pymssql、pyodbc など）に変換します。
4. レスポンスは、AI用の標準JSON構造に整形されます。

これにより、AIのプロンプトやロジックを変更することなく、設定を変更するだけでデータベースを切り替えることができます。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSE ファイルを参照してください。