Winform MCP Server

🚀 WinForm MCP Server

このアプリケーションは、Windows Forms をベースにした機能が充実した MCP (Model Context Protocol) のデモアプリです。MCP Server、Mcp Client、組み込み Web サービス、LLM API 呼び出し、チャットインターフェイス、ツール管理などの機能が統合されており、企業向けデスクトップアプリケーション開発における特定技術の参考コードとして利用できます。

🚀 クイックスタート

1. ビルドと実行

Visual Studio を使用する場合：

• ソリューション src\WinFormMcpServer.sln を開きます。
• ビルド構成（Debug/Release）を選択し、デバッグを開始（F5）または実行（Ctrl+F5）します。

.NET CLI を使用する場合：

# プロジェクトディレクトリに移動
cd src/WinFormMcpServer

# プロジェクトをビルド
dotnet build

# アプリケーションを起動
dotnet run

2. アプリケーションの設定

サーバーを起動する：

1. メインウィンドウでポートを入力します（デフォルトは 3000）。
2. 「サーバーを起動」ボタンをクリックします。
3. ステータスバーに「実行中」と表示されれば、サービスが起動しています。

LLM API を設定する：

1. メニューバーの「設定」→「LLM API 設定」をクリックします。
2. Mock API または実際の API を選択します。
3. 実際の API を使用する場合は、以下の設定情報を入力します：
   • API の基本 URL（例：https://api.openai.com/v1）
   • API キー
   • モデル名（例：gpt-3.5-turbo）
   • その他のパラメータ（タイムアウト時間、最大トークン数、温度など）
4. 「接続テスト」をクリックして設定を検証します。
5. 設定を保存します。

3. チャットインターフェイスの使用

http://localhost:3000 にアクセスして、最新の Web チャットインターフェイスを開きます：

• リアルタイムのメッセージの送受信がサポートされています。
• レスポンシブデザインで、あらゆるデバイスに対応しています。
• MCP ツールの呼び出しと結果の表示がサポートされています。

✨ 主な機能

🤖 LLM API の統合

• 設定可能な LLM サービス：Mock API と実際の API の間をシームレスに切り替えることができます。
• OpenAI 互換インターフェイス：すべての OpenAI 互換の API エンドポイントをサポートしています。
• スマートな設定管理：設定は自動的に JSON ファイルに保存され、ホットアップデートがサポートされています。
• 接続テスト：組み込みの API 接続テスト機能で、設定が正しいことを確認できます。

💬 現代的なチャットインターフェイス

• Web チャットインターフェイス：最新の Web 技術をベースにしたレスポンシブなチャットインターフェイスです。
• リアルタイムメッセージ処理：リアルタイムのメッセージの送受信がサポートされています。
• 美しい UI デザイン：青灰色調の現代的なデザインスタイルが採用されています。
• モバイル対応：完全なレスポンシブデザインで、あらゆる画面サイズに対応しています。

🔧 MCP ツールシステム

• ツール管理：完全な MCP ツールの登録と管理システムが備わっています。
• リモートツール呼び出し：HTTP エンドポイントを介して MCP ツールを呼び出すことができます。
• ツールテスト：組み込みのツールテストインターフェイスで、デバッグと検証が容易です。
• 拡張性：カスタムツールの開発と統合がサポートされています。

⚙️ 設定管理

• MCP サーバー設定：複数の MCP サーバーの設定と管理がサポートされています。
• JSON 設定編集：視覚的な JSON 設定エディタが備わっています。
• 設定の永続化：すべての設定は自動的に保存され、アプリケーションを再起動しても保持されます。

📦 インストール

前提条件

• .NET SDK 8.0 以上
• オプション：Visual Studio 2022（Community 版を推奨）

💻 使用例

基本的な使用法

# .NET CLI を使用してプロジェクトをビルドして実行する例
cd src/WinFormMcpServer
dotnet build
dotnet run

高度な使用法

# リリースビルドを行い、win-x64 アーキテクチャ用にセルフコンテナ化する例
dotnet publish src/WinFormMcpServer -c Release -r win-x64 --self-contained true

📚 ドキュメント

🔌 API エンドポイント

MCP プロトコルエンドポイント

• 基本アドレス：http://localhost:{port}/mcp
• SSE 接続：http://localhost:{port}/sse
• チャット API：http://localhost:{port}/api/chat

静的リソース

• チャットインターフェイス：http://localhost:{port}/index
• 静的ファイル：http://localhost:{port}/wwwroot/

📁 プロジェクト構造

src/WinFormMcpServer/
├── Controllers/           # API コントローラー
│   └── ChatController.cs  # チャット API コントローラー
├── McpServer/            # MCP サーバーのコア
│   ├── HttpMcpServer.cs  # HTTP MCP サーバー
│   ├── McpServerHost.cs  # MCP サーバーホスト
│   └── Tools/            # MCP ツールの集合
├── Models/               # データモデル
│   ├── ChatModels.cs     # チャット関連のモデル
│   ├── LlmApiConfig.cs   # LLM API 設定モデル
│   └── McpClientConfig.cs # MCP クライアント設定モデル
├── Services/             # ビジネスサービス
│   ├── ChatService.cs    # チャットサービス
│   ├── ConfigurableLlmService.cs # 設定可能な LLM サービス
│   ├── LlmApiConfigService.cs    # LLM API 設定サービス
│   ├── LlmApiServiceFactory.cs   # LLM API サービスファクトリ
│   ├── RealLlmApiService.cs      # 実際の LLM API サービス
│   ├── MockLlmApiService.cs      # Mock LLM API サービス
│   └── McpClientService.cs       # MCP クライアントサービス
├── wwwroot/              # Web 静的リソース
│   ├── index.html        # チャットインターフェイス
│   ├── chat.js          # チャットスクリプト
│   └── styles.css       # スタイルファイル
├── MainForm.cs          # メインウィンドウ
├── LlmApiConfigForm.cs  # LLM API 設定ウィンドウ
├── McpConfigForm.cs     # MCP 設定ウィンドウ
└── Program.cs           # プログラムのエントリーポイント

🔧 設定ファイル

LLM API 設定 (llm-api-config.json)

{
  "UseMockApi": false,
  "BaseUrl": "https://api.openai.com/v1",
  "ApiKey": "your-api-key-here",
  "ModelName": "gpt-3.5-turbo",
  "TimeoutSeconds": 30,
  "MaxTokens": 1000,
  "Temperature": 0.7
}

MCP サーバー設定 (mcp-servers.json)

{
  "mcpServers": {
    "example-server": {
      "type": "sse",
      "url": "http://localhost:3001/sse",
      "name": "示例服务器"
    }
  }
}

📊 ログシステム

• ログフレームワーク：Serilog
• ログの保存場所：logs/WinFormMcpServer_.log
• ローテーション戦略：毎日ローテーション
• ログレベル：Verbose（開発環境）

🧪 テスト

エンドツーエンドテスト

テストスクリプトは test/ ディレクトリにあります：

• Playwright を使用したフロントエンドの自動化テストが可能です。
• API エンドポイントのテストがサポートされています。
• チャット機能の統合テストが含まれています。

MCP Inspector テスト

# MCP Inspector をインストール
npx @modelcontextprotocol/inspector

# テストインターフェイスにアクセス
http://localhost:6247/

📦 リリースとデプロイ

フレームワーク依存デプロイ

dotnet publish src/WinFormMcpServer -c Release -r win-x64 --self-contained false

セルフコンテナ化デプロイ

dotnet publish src/WinFormMcpServer -c Release -r win-x64 --self-contained true

リリース成果物は bin/Release/net8.0-windows/win-x64/publish/ にあります。

🔗 MCP クライアントの統合

あなたの MCP クライアント設定に以下を追加します：

{
  "mcpServers": {
    "winform-mcp-server": {
      "type": "sse",
      "url": "http://localhost:3000/sse",
      "name": "WinForm MCP Server"
    }
  }
}

🤝 コントリビューションガイド

1. このリポジトリを fork します。
2. 機能ブランチを作成します (git checkout -b feature/AmazingFeature)。
3. 変更をコミットします (git commit -m 'Add some AmazingFeature')。
4. ブランチにプッシュします (git push origin feature/AmazingFeature)。
5. Pull Request を作成します。

📄 ライセンス

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

🆘 サポート

問題が発生した場合や質問がある場合は、以下の手順に従ってください：

1. Issues ページを確認します。
2. 新しい Issue を作成して問題を説明します。
3. 詳細なエラー情報と再現手順を提供します。

⚠️ 重要提示

このプロジェクトは企業向けの MCP サーバーを実装したもので、完全な LLM API 呼び出し、現代的なチャットインターフェイス、ツール管理機能が統合されており、本番環境でのデプロイに適しています。