Mssqlclient MCP Server

🚀 SQL Server MCP クライアント

SQL Server MCP クライアントは、.NET ベースのプログラムで、Microsoft SQL Server データベースに接続して操作するために使用されます。MCP（Microsoft Common Platform）プロトコルを実装することで、SQL Server とのインターフェースを提供します。

✨ 主な機能

• データベース接続：複数の認証方式を通じて SQL Server に接続できます。
• データ操作：基本的な CRUD（作成、読み取り、更新、削除）操作機能を提供します。
• クエリ実行：ユーザーがカスタム SQL クエリを実行し、結果セットを表示できます。
• 接続文字列の設定：環境変数を通じてデータベース接続情報を設定できます。

🚀 クイックスタート

前提条件

1. プログラムが正常に動作するように、.NET ランタイム環境をインストールしてください。
2. Docker で実行する場合は、Docker がインストールされていることを確認してください。
3. 有効な SQL Server データベースと適切なアクセス権限があることを確認してください。

ビルド手順

ソースコードからプロジェクトをビルドするには、以下の手順に従ってください。

1. このリポジトリをローカル開発環境にクローンします。
2. ターミナルまたはコマンドプロンプトを開き、プロジェクトのルートディレクトリに移動します。
3. 以下のコマンドを実行してビルドします。

dotnet build --configuration Release

📦 Docker サポート

ローカル Registry の使用

プロジェクトのビルド成果物を Docker イメージとして公開し、以下のコマンドを使用して実行します。

docker run -it --rm -e "MSSQL_CONNECTIONSTRING=Server=your_server;Database=your_db;User Id=your_user;Password=your_password;TrustServerCertificate=True;" YOUR_REGISTRY/mssqlclient:latest

手動での Docker ビルド

プロジェクトのルートディレクトリで、以下のコマンドを実行して Docker イメージをビルドします。

docker build -t mssqlclient .

その後、以下のコマンドを使用してイメージを実行します。

docker run -it --rm -e "MSSQL_CONNECTIONSTRING=Server=your_server;Database=your_db;User Id=your_user;Password=your_password;TrustServerCertificate=True;" mssqlclient

Docker のプッシュ

イメージをプライベートまたはパブリック Registry にプッシュするには、以下のコマンドを実行します。

docker push YOUR_REGISTRY/mssqlclient:latest

📚 ドキュメント

MCP プロトコルの使用方法

クライアントの統合

Claude デスクトップで SQL Server MCP クライアントを構成するには、2 つの方法があります。

ローカルインストール

1. Claude デスクトップの設定ファイルにサーバー設定を追加します。

"mssql": {
  "command": "dotnet",
  "args": [
    "YOUR_PATH_TO_DLL\\Core.Infrastructure.McpServer.dll"
  ],
  "env": {
    "MSSQL_CONNECTIONSTRING": "Server=your_server;Database=your_db;User Id=your_user;Password=your_password;TrustServerCertificate=True;"
  }
}

2. ファイルを保存し、Claude デスクトップを再起動します。

Docker コンテナの使用

1. Claude デスクトップの設定に以下の内容を追加します。

"mssql": {
  "command": "docker",
  "args": [
    "run",
    "--rm",
    "-i",
    "-e", "MSSQL_CONNECTIONSTRING=Server=your_server;Database=your_db;User Id=your_user;Password=your_password;TrustServerCertificate=True;",
    "localhost:5000/mssqlclient-mcp-server:latest"
  ]
}

2. ファイルを保存し、Claude デスクトップを再起動します。

設定

データベース接続文字列

SQL Server 接続文字列を構成する際には、以下の情報を含めるようにしてください。

• サーバー名 または IP アドレス
• データベース名
• 認証方式
• ユーザー名 と パスワード

接続文字列の例：

Server=my-server;Database=my-database;User Id=my-user;Password=my-password;TrustServerCertificate=True;

⚠️ 注意事項

1. すべての環境変数と設定情報のセキュリティを確保し、機密データの漏洩を防いでください。
2. 本番環境で使用する前に、十分なテストと検証を行ってください。

📄 ライセンス

詳細なライセンス情報については、プロジェクトの LICENSE ファイルを参照してください。