Mcpsqlserver

🚀 SQL Server MCP サーバー for Windsurf IDE

独立した C# で記述された MCP（モデルコンテキストプロトコル）サーバーで、Windsurf IDE への SQL Server 統合機能を提供します。

🚀 クイックスタート

この SQL Server MCP サーバーは、Windsurf IDE で SQL Server を利用するための統合機能を提供します。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

• SQL Server 接続機能
• データベーススキーマの探索
• テーブルとビューの調査
• 列メタデータの取得
• ストアドプロシージャの列挙
• SQL クエリの実行
• ストアドプロシージャの実行
• トラブルシューティング用のデバッグモード
• 設定可能なログパス

📦 インストール

前提条件

• .NET 9.0 SDK 以上
• SQL Server インスタンス（ローカルまたはリモート）
• SQL Server クライアントツール

セットアップ手順

1. プロジェクトのビルド：

dotnet build

2. アプリケーションの設定：
   • appsettings.example.json を appsettings.json にコピーします。
   • appsettings.json 内の接続文字列とその他の SQL Server の詳細を更新します。

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=your-server;Database=master;User ID=your-username;Password=your-password;TrustServerCertificate=True"
  },
  "LogPath": "C:\\Path\\To\\Your\\LogDirectory\\",
  "DebugMode": "false"
}

3. Windsurf で MCP サーバーを設定：
   • windsurf_mcp_config.json をあなたの Windsurf MCP 設定ファイル（通常は ~/.codeium/windsurf/mcp_config.json）にコピーします。
   • パスをあなたのビルド実行ファイルを指すように更新します。

{
  "mcpServers": {
    "sqlMcpService": {
      "command": "path/to/your/MCPSqlServer.exe",
      "args": [],
      "description": "SQL Server MCP Service"
    }
  }
}

4. GitHub 統合の設定：
   • プロジェクトの新しい GitHub リポジトリを作成します。
   • プロジェクトディレクトリで新しい Git リポジトリを初期化します。git init
   • あなたの GitHub リポジトリをリモートとして追加します。git remote add origin <repository-url>
   • 変更をリモートリポジトリにプッシュします。git push -u origin master

📚 ドキュメント

設定オプション

appsettings.json ファイルには以下の設定オプションが含まれています。

公開

以下のコマンドを使用して、自己完結型の実行ファイルを公開できます。

dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true

これにより、単一の実行ファイルが生成されます。

コード構造

アプリケーションは以下のように構成されています。

• Program.cs：メインエントリポイントとリクエスト処理
• JsonRpcHandler.cs：JSON-RPC プロトコルを処理し、リクエストを配信
• 設定は appsettings.json から読み込まれます。
• ログは LogPath 設定で指定されたファイルに書き込まれます。

貢献方法

貢献を歓迎します！自由に Pull Request を送信してください。

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

ライセンス

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

エラー処理

一般的なエラーコード：