MSSQL Database Manager

🚀 MSSQL MCP サーバー

MSSQL MCP サーバーは、Model Context Protocol (MCP) に基づくサーバーで、Microsoft SQL Server (MSSQL) データベースとの安全かつ構造化されたやり取りを実現することを目的としています。このサーバーを通じて、AI アシスタントは以下の操作を実行できます。

• 利用可能なテーブルを一覧表示する
• テーブルの内容を表示する
• 制御されたアクセスの SQL クエリを実行する

これにより、より安全なデータベース探索、厳格な権限管理、およびデータベースとのやり取りのログ記録が可能になります。

✨ 主な機能

• 環境変数を通じた MSSQL データベースの安全なアクセス
• エラー処理機能を備えた 制御されたクエリ実行
• テーブルカタログとデータの検索機能
• クエリと操作の監視のための包括的なログ記録

📦 インストール

pip install mssql-mcp-server

📚 ドキュメント

設定

以下の環境変数を設定することで、データベースへのアクセスを構成します。

MSSQL_DRIVER=mssql_driver
MSSQL_HOST=localhost
MSSQL_USER=your_username
MSSQL_PASSWORD=your_password
MSSQL_DATABASE=your_database
# オプション
TrustServerCertificate=yes
Trusted_Connection=no

使用方法

Claude Desktop への統合

Claude Desktop で使用するには、claude_desktop_config.json ファイルに以下の設定を追加します。

{
  "mcpServers": {
    "mssql": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/mssql_mcp_server",
        "run",
        "mssql_mcp_server"
      ],
      "env": {
        "MSSQL_DRIVER": "mssql_driver",
        "MSSQL_HOST": "localhost",
        "MSSQL_USER": "your_username",
        "MSSQL_PASSWORD": "your_password",
        "MSSQL_DATABASE": "your_database"
      }
    }
  }
}

独立したサーバーとしての実行

# 依存関係のインストール
pip install -r requirements.txt

# サーバーの実行
python -m mssql_mcp_server

開発

# リポジトリのクローン
git clone https://github.com/yourusername/mssql_mcp_server.git
cd mssql_mcp_server

# 仮想環境の作成
python -m venv venv
source venv/bin/activate  # Windows の場合は：venv\Scripts\activate

# 開発用の依存関係のインストール
pip install -r requirements-dev.txt

# テストの実行
pytest

セキュリティに関する注意事項

• MSSQL ユーザーには最小限の権限を与えるようにしてください。
• 決してルート資格情報や完全な管理権限を持つアカウントを使用しないでください。
• データベースへのアクセスを制限し、必要な操作のみを許可してください。
• セキュリティ監査のために、ログ記録と監視機能を有効にしてください。
• 定期的に権限を見直し、最小権限の原則に従うようにしてください。

セキュリティのベストプラクティス

安全な構成を実現するには、以下の手順を実行してください。

1. 制限された権限を持つ MSSQL ユーザーを作成します。
2. 資格情報をハードコードしないでください。環境変数を使用して管理します。
3. アクセスを制限し、必要なテーブルと操作にのみ権限を付与します。
4. SQL Server のログ記録と監視機能を有効にします。
5. 定期的にデータベースへのアクセス権限を見直し、許可されていないアクセスを防止します。

詳細な説明については、MSSQL セキュリティ構成ガイド を参照してください。

⚠️ 重要提示

常に 最小権限の原則 に従ってデータベースへのアクセスを構成してください。

貢献

私たちは貢献を歓迎します！貢献するには、以下の手順を実行してください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します：git checkout -b feature/amazing-feature
3. 変更をコミットします：git commit -m 'Add amazing feature'
4. ブランチにプッシュします：git push origin feature/amazing-feature
5. Pull Request を開きます。

📄 ライセンス

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

ヘルプが必要ですか？

何か質問や疑問がある場合は、こちら までお問い合わせください。