Winform MCP Server

🚀 WinForm MCP Server

這是一個功能完備的基於 Windows Forms 的 MCP (Model Context Protocol) 應用 Demo，集成了 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）
     • 其他參數（超時時間、最大 tokens、溫度等）
  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

高級用法

使用 Visual Studio 進行調試和開發：

• 打開解決方案 src\WinFormMcpServer.sln。
• 選擇構建配置（Debug/Release），直接啟動調試（F5）或運行（Ctrl+F5）。

📚 詳細文檔

🔌 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"
    }
  }
}

📄 許可證

本項目採用 MIT 許可證 - 查看 LICENSE 文件瞭解詳情。

🆘 支持

如果您遇到問題或有疑問，請：

1. 查看 Issues 頁面。
2. 創建新的 Issue 描述問題。
3. 提供詳細的錯誤信息和復現步驟。

⚠️ 重要提示

本項目為企業級 MCP 服務器實現，集成了完整的 LLM API 調用、現代化聊天界面和工具管理功能，適用於生產環境部署。

🤝 貢獻指南

1. Fork 本倉庫。
2. 創建功能分支 (git checkout -b feature/AmazingFeature)。
3. 提交更改 (git commit -m 'Add some AmazingFeature')。
4. 推送到分支 (git push origin feature/AmazingFeature)。
5. 開啟 Pull Request。