Scan to join WeChat grouparticle
README
🚀 喜剧 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 操作系统
安装步骤
- 克隆代码仓库：
git clone [仓库地址]
cd ComedyMCPServer
- 修复依赖项：
dotnet restore
- 编译项目：
dotnet build
- 运行服务器：
dotnet run
运行选项
启动模式
- 开发模式：在调试模式下运行，支持热重载。
dotnet run --configuration Debug
- 生产模式：以优化方式运行。
dotnet run --configuration Release
停止和重启
按 Ctrl + C 终止服务器，然后重新运行命令以重启。
📚 详细文档
API 文档
当服务器运行时，访问 Swagger UI：
/swagger
贡献
欢迎贡献！请：
- 实现新的喜剧相关工具。
- 改进现有的笑话生成功能。
- 提升错误处理和日志记录。
- 添加新的喜剧服务。
📄 许可证
[在此处填写许可证信息]