Comedy MCP Server

基本能力

产品定位

Comedy MCP Server 是一个为 AI 助手提供喜剧相关功能的 MCP 服务器，主要用于生成编程笑话和有趣的代码注释。

核心功能

• 编程笑话生成：随机生成与编程相关的笑话。
• 代码注释生成：根据代码上下文和主题生成幽默的注释。
• 回声服务：展示日志功能的演示服务。
• Swagger 集成：提供 API 文档和测试接口。
• 健康检查端点：基本的服务器状态监控。

适用场景

• 在 AI 助手中集成喜剧功能，提升用户体验。
• 为开发者提供幽默的代码注释和笑话，缓解编程压力。
• 用于演示和测试 MCP 服务器的功能。

工具列表

1. GetProgrammingJoke
2. 能力：获取一个随机的编程相关笑话。
3. 参数：无。

4. 返回：包含笑话的字符串。

5. GetCodeComment

6. 能力：生成与特定代码上下文相关的有趣注释。
7. 参数：
   • codeContext：代码片段或上下文。
   • topic：注释的主题。

8. 返回：与代码相关的幽默注释。

9. EchoWithLog

10. 能力：演示工具，带日志记录的回显消息。
11. 参数：
    • message：要回显的消息。
12. 返回：回显的消息。

常见问题解答

1. 端口已被占用：

2. 解决方案：在 appsettings.json 中更改端口或停止占用当前端口的进程。

3. 依赖缺失：

4. 解决方案：再次运行 dotnet restore 并检查 .NET SDK 版本是否匹配项目要求。

5. 环境变量未加载：

6. 解决方案：确保 .env 文件存在且格式正确，修改环境文件后重启应用程序。

使用教程

使用依赖

• .NET 8.0 SDK 或更高版本。
• Node.js 14+（用于 MCP 检查工具）。
• 代码编辑器（推荐使用 Cursor IDE 以获得最佳集成体验）。
• Git（用于版本控制）。

安装教程

1. 克隆仓库：

git clone [your-repository-url]
cd ComedyMcpServer

1. 设置环境：
2. 复制示例环境文件： bash copy .env.example .env # Windows # 或 cp .env.example .env # Unix 系统

3. 根据需要更新 .env 文件。

4. 安装依赖：

dotnet restore

1. 构建项目：

dotnet build

运行服务器

1. 开发模式：

dotnet run --environment Development

1. 使用 MCP 检查器（推荐用于调试 MCP 工具）：

npx @modelcontextprotocol/inspector dotnet run

1. 生产模式：

dotnet run --environment Production

调试方式

1. 检查服务器是否运行：
2. 打开浏览器访问 http://localhost:5000 或配置的端口。

3. 应看到消息 "Comedy MCP Server is running!"。

4. 访问 Swagger 文档：

5. 导航到 http://localhost:5000/swagger。

6. 应看到 API 文档。

7. 测试 MCP 工具：

8. 使用包含的测试脚本： bash node test-mcp.js
9. 或使用 MCP 检查器界面（如果使用检查器运行）。

许可证

None