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. 添加新的喜剧服务。

📄 许可证

[在此处填写许可证信息]