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 工具： | 工具名称 | 描述 | 参数 | 返回值 | | ---- | ---- | ---- | ---- | | GetProgrammingJoke | 检索一个随机的编程相关笑话 | 无 | 包含笑话的字符串 | | GetCodeComment | 根据特定代码上下文和主题生成幽默注释 | codeContext：代码片段或上下文；topic：主题 | 包含幽默注释的字符串 | | 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. 添加新的喜剧服务。

📄 许可证

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