Microsoft SQL Server MCP Server

🚀 マイクロソフト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  # または `venv\Scripts\activate` (Windowsの場合)

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

# テストの実行
pytest

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

• 環境変数や認証情報をバージョン管理システムにコミットしないでください
• アクセス権が制限されたデータベースユーザーを使用してください
• 本番環境ではクエリホワイトリスト機構を実装することをおすすめします
• すべてのデータベース操作を監視し、記録してください

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

このMCPサーバーは、正常に動作するためにデータベースへのアクセス権が必要です。セキュリティを確保するために：

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

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

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

⚠️ 重要提示

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

📄 ライセンス

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

貢献ガイド

1. リポジトリをForkします
2. 機能ブランチを作成します（例：git checkout -b feature/amazing-feature）
3. 変更をコミットします（例：git commit -m '素晴らしい機能を追加'）
4. ブランチにプッシュします（例：git push origin feature/amazing-feature）
5. Pull Requestを送信します

以上の手順で、このプロジェクトに貢献することができます。