Richardhan Mssql 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 Desktopと一緒に使用する場合

この内容を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. リポジトリをフォークします
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を作成します