AI导哈

喜剧AI工具服务

一个基于Model Context Protocol (MCP)的服务器实现，为AI助手提供编程笑话和幽默代码注释生成等喜剧相关功能。

  • by Tanner253
  • C#
  • 本地部署
  • 更新于
在 GitHub 查看 tanner253/comedymcpserver

使用说明

喜剧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工具：

  1. GetProgrammingJoke

    • 描述：检索随机编程相关笑话
    • 参数：无
    • 返回：一个包含笑话的字符串

  2. GetCodeComment

    • 描述：生成与特定代码上下文相关的有趣注释
    • 参数：
      • codeContext：代码片段或上下文
      • topic：评论的主题
    • 返回：与代码相关的幽默评论

  3. EchoWithLog

    • 描述：通过日志记录来回复消息的演示工具
    • 参数：
      • message：要回应的消息
    • 返回：返回的消息

设置和配置

先决条件

  • .NET 8.0 SDK或更高版本
  • Node.js 14+（用于MCP检查器工具）
  • 代码编辑器（最好是Cursor IDE，以实现最佳集成）
  • Git（用于版本控制）

安装步骤

  1. 克隆存储库：
git clone [your-repository-url]
cd ComedyMcpServer

  1. 设置环境：

    • 复制示例环境文件：
      copy .env.example .env    # On Windows
# OR
cp .env.example .env     # On Unix-based systems
    • 更新 .env 如果需要，使用您的设置文件

  2. 安装依赖项：

dotnet restore
  1. 构建项目：
dotnet build

运行服务器

您有几个选项可以运行服务器：

  1. 发展模式:
dotnet run --environment Development
  1. 与MCP检查员一起 （建议用于调试MCP工具）：
npx @modelcontextprotocol/inspector dotnet run
  1. 生产模式:
dotnet run --environment Production

验证安装

  1. 检查服务器是否正在运行：

    • 打开浏览器 http://localhost:5000 或配置的端口
    • 您应该看到消息“喜剧MCP服务器正在运行！”

  2. 访问Swagger文档：

    • 引导到 http://localhost:5000/swagger
    • 您应该查看API文档

  3. 测试MCP工具：

    • 使用附带的测试脚本：
      node test-mcp.js
    • 如果与检查器一起运行，则使用MCP检查器界面

故障排除

常见问题和解决方案：

  1. 端口已在使用中：

    • 更改端口 appsettings.json
    • 或者使用当前端口停止进程

  2. 缺少依赖关系：

    • 跑 dotnet restore 再次
    • 检查你的。NET SDK版本符合项目要求

  3. 未加载环境变量：

    • 确保 .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

贡献

欢迎通过以下方式做出贡献：

  1. 实施新的喜剧相关工具
  2. 增强现有的笑话生成能力
  3. 改进错误处理和日志记录
  4. 添加新的喜剧服务

许可证

[您的许可证信息在此处]

相关 MCP