Comedymcpserver

🚀 喜劇 MCP 服務器

喜劇 MCP 服務器基於 Model Context Protocol (MCP) 實現，為 AI 助手集成了喜劇相關的工具和服務。它與 Cursor IDE 集成，藉助 MCP 工具提供各類喜劇功能，能為編程增添樂趣。

🚀 快速開始

喜劇 MCP 服務器使用 ASP.NET Core 構建，實現了 Model Context Protocol (MCP)，可為 AI 助手提供生成編程笑話和有趣代碼註釋的功能，是 AI 模型與喜劇相關功能之間的橋樑。

✨ 主要特性

• 編程笑話：可生成隨機的編程相關笑話。
• 代碼註釋：能根據代碼上下文和主題生成幽默的註釋。
• 回顯服務：具備日誌記錄功能的演示服務。
• Swagger 集成：提供 API 文檔和測試界面。
• 健康檢查端點：可對服務器基本狀態進行監控。

🔧 技術細節

架構

該服務器包含以下組件：

• MCP 服務器集成：使用 ModelContextProtocol.Server 實現 MCP。
• 喜劇服務：實現 IComedyService 用於笑話和註釋生成。
• HTTP 通信：通過標準輸入輸出與 Cursor IDE 通信。
• 日誌記錄：支持配置日誌級別的全面日誌記錄。
• CORS 支持：配置以支持 MCP 檢查工具。

工具

該服務器提供了以下 MCP 工具：

1. GetProgrammingJoke
   • 描述：檢索一個隨機的編程相關笑話。
   • 參數：無。
   • 返回值：包含笑話的字符串。
2. GetCodeComment
   • 描述：根據特定代碼上下文和主題生成幽默註釋。
   • 參數：
     • codeContext：代碼片段或上下文。
     • topic：主題。
   • 返回值：包含幽默註釋的字符串。
3. EchoService
   • 描述：演示回顯功能，帶有日誌記錄。
   • 參數：無。
   • 返回值：輸入的原樣返回。

📦 安裝指南

系統要求

• .NET SDK 6.0 或更高版本。
• Windows、Linux 或 macOS 操作系統。

安裝步驟

1. 克隆代碼倉庫：

git clone [倉庫地址]
cd ComedyMCPServer

2. 修復依賴項：

dotnet restore

3. 編譯項目：

dotnet build

4. 運行服務器：

dotnet run

運行選項

啟動模式

• 開發模式：在調試模式下運行，支持熱重載。

dotnet run --configuration Debug

• 生產模式：以優化方式運行。

dotnet run --configuration Release

停止和重啟

按 Ctrl + C 終止服務器，然後重新運行命令以重啟。

📚 詳細文檔

API 文檔

當服務器運行時，可訪問 Swagger UI：

/swagger

🤝 貢獻

歡迎貢獻！可進行以下操作：

1. 實現新的喜劇相關工具。
2. 改進現有的笑話生成功能。
3. 提升錯誤處理和日誌記錄。
4. 添加新的喜劇服務。

📄 許可證

[在此處填寫許可證信息]