喜剧MCP服务器
一种模型上下文协议（MCP）服务器实现，为人工智能助手提供喜剧相关的工具和服务。该服务器与Cursor IDE集成，并通过MCP工具提供各种与喜剧相关的功能。
概述
喜剧MCP服务器是使用ASP。NET Core，并实现了模型上下文协议（MCP），为AI助手提供生成编程笑话和有趣代码注释的工具。它是人工智能模型和喜剧相关功能之间的桥梁。
特性
- 编程笑话：生成与随机编程相关的笑话
- 代码注释：根据代码上下文和主题创建幽默评论
- 回声服务：显示日志记录功能的演示服务
- Swagger集成：API文件和测试接口
- 健康检查端点：基本服务器状态监视
建筑
服务器由以下组件构建：
- MCP服务器集成：用途
ModelContextProtocol.Server用于MCP实施 - 喜剧服务：实施
IComedyService用于生成笑话和评论 - HTTP通信：使用stdio与Cursor IDE通信
- 日志记录：具有可配置级别的全面日志记录
- CORS支持：为MCP检查器工具配置
工具
服务器提供以下MCP工具：
GetProgrammingJoke
- 描述：检索随机编程相关笑话 - 参数：无 - 返回：一个包含笑话的字符串
GetCodeComment
- 描述：生成与特定代码上下文相关的有趣注释 - 参数： - codeContext：代码片段或上下文 - topic：评论的主题 - 返回：与代码相关的幽默评论
EchoWithLog
- 描述：通过日志记录来回复消息的演示工具 - 参数： - message：要回应的消息 - 返回：返回的消息
设置和配置
先决条件
- .NET 8.0 SDK或更高版本
- Node.js 14+（用于MCP检查器工具）
- 代码编辑器（最好是Cursor IDE，以实现最佳集成）
- Git（用于版本控制）
安装步骤
- 克隆存储库：
git clone [your-repository-url]
cd ComedyMcpServer- 设置环境：
- 复制示例环境文件：
copy .env.example .env # On Windows
# OR
cp .env.example .env # On Unix-based systems- 更新 .env 如果需要，使用您的设置文件
- 安装依赖项：
dotnet restore- 构建项目：
dotnet build运行服务器
您有几个选项可以运行服务器：
- 发展模式:
dotnet run --environment Development- 与MCP检查员一起 （建议用于调试MCP工具）：
npx @modelcontextprotocol/inspector dotnet run- 生产模式:
dotnet run --environment Production验证安装
- 检查服务器是否正在运行：
- 打开浏览器 http://localhost:5000 或配置的端口 - 您应该看到消息“喜剧MCP服务器正在运行！”
- 访问Swagger文档：
- 引导到 http://localhost:5000/swagger - 您应该查看API文档
- 测试MCP工具：
- 使用附带的测试脚本：
node test-mcp.js- 如果与检查器一起运行，则使用MCP检查器界面
故障排除
常见问题和解决方案：
- 端口已在使用中：
- 更改端口 appsettings.json - 或者使用当前端口停止进程
- 缺少依赖关系：
- 跑 dotnet restore 再次 - 检查你的。NET SDK版本符合项目要求
- 未加载环境变量：
- 确保 .env 文件存在并且格式正确 - 修改环境文件后重新启动应用程序
有关更详细的问题，请检查控制台输出中的应用程序日志。
发展
该项目遵循标准ASP。NET Core与其他MCP特定组件的实践：
- 服务在DI容器中注册
- 从装配中自动发现工具
- 日志记录已配置用于开发和调试
- Swagger可用于API文档
部署
该项目包括：
Procfile：用于平台部署nixpacks.toml：构建配置- 标准ASP。NET Core部署选项
测试
测试脚本(test-mcp.js)用于验证MCP功能。
健康检查
访问根端点(/)要验证服务器状态，请执行以下操作：
GET / -> "Comedy MCP Server is running!"API文档
运行时，访问Swagger UI：
/swagger贡献
欢迎通过以下方式做出贡献：
- 实施新的喜剧相关工具
- 增强现有的笑话生成能力
- 改进错误处理和日志记录
- 添加新的喜剧服务
许可证
\[您的许可证信息在此处\]
