Microsoft SQL Server (MSSQL)

🚀 マイクロソフトSQL Server MCPサーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を使用して、マイクロソフトSQL Serverデータベースと安全にやり取りするためのものです。AIアシスタントがテーブルを一覧表示し、データを読み取り、適切なエラー処理を伴うSQLクエリを実行できるようにし、制御されたインターフェースを通じてデータベースの探索と分析を行い、より安全で構造化された操作を可能にします。

✨ 主な機能

• 利用可能なSQL Serverテーブルをリソースとして一覧表示
• テーブル内容を読み取り
• SQLクエリを実行し、適切なエラー処理を行う
• 環境変数を通じてデータベースへの安全なアクセスを実現
• 包括的なログ記録
• システム依存関係の自動インストール

📦 インストール

MCPを通じてインストールする際に、必要なシステム依存関係（例：FreeTDS）が自動的にインストールされます。

pip install mssql-mcp-server

📚 ドキュメント

設定

以下の環境変数を設定してください。

MSSQL_SERVER=localhost
MSSQL_USER=your_username
MSSQL_PASSWORD=your_password
MSSQL_DATABASE=your_database

使用方法

Claudeデスクトップとの連携

以下の内容をclaude_desktop_config.jsonに追加してください。

{
  "mcpServers": {
    "mssql": {
      "command": "uv",
      "args": [
        "--directory", 
        "path/to/mssql_mcp_server",
        "run",
        "mssql_mcp_server"
      ],
      "env": {
        "MSSQL_SERVER": "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/RichardHan/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

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

• 環境変数や認証情報を決してコミットしないでください。
• 最小限の権限を持つデータベースユーザーを使用してください。
• 本番環境ではクエリホワイトリストを実装することを検討してください。
• すべてのデータベース操作を監視し、記録してください。

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

このMCPサーバーは、データベースへのアクセス権限が必要です。セキュリティ上の理由から：

1. 専用のSQL Serverログインを作成し、最小限の権限を付与します。
2. sa認証情報や管理アカウントを使用しないでください。
3. データベースアクセスを必要最小限の操作に制限します。
4. 監査目的でログ記録を有効化します。
5. 定期的にデータベースアクセスのセキュリティレビューを行います。

詳細な説明は、SQL Serverセキュリティ構成ガイドを参照してください。これには以下の内容が含まれます：

• 制限付きのSQL Serverログインの作成方法
• 適切な権限の設定方法
• データベースアクセスの監視方法
• セキュリティのベストプラクティス

⚠️ 重要：常に最小特権の原則に従ってデータベースアクセスを構成してください。

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

💪 貢献の方法

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