Mssql MCP Server

🚀 Microsoft SQL Server の 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 セキュリティ設定ガイド を参照してください。

⚠️ 重要提示

常にデータベースアクセスの設定において 最小権限の原則 に従ってください。

📄 ライセンス

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

貢献

貢献を歓迎します！貢献するには、以下の手順に従ってください。

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 を開きます。

ヘルプが必要ですか？

何か問題や質問がある場合は、GitHub 上の Issue を開くか、メンテナに連絡してください。