Comedy MCP Server

Comedy MCP Server

Okay, here's a translation of the request "MCP server using C# SDK to enhance comments with jokes from JokeAPI.": **Simplified Chinese:** 使用 C# SDK 的 MCP 服务器，用 JokeAPI 的笑话来增强评论。 **Traditional Chinese:** 使用 C# SDK 的 MCP 伺服器，用 JokeAPI 的笑話來增強評論。 **Explanation of the translation choices:** * **MCP Server:** This is kept as "MCP 服务器/伺服器" as it's likely a specific term related to the project and should be recognizable. If you have more context about what "MCP" stands for, I can provide a more accurate translation. * **C# SDK:** This is kept as "C# SDK" as it's a standard technical term. * **Enhance comments:** "增强评论/增強評論" is a direct and common translation for "enhance comments." * **Jokes from JokeAPI:** "JokeAPI 的笑话/笑話" translates to "jokes from JokeAPI." Again, keeping "JokeAPI" as is since it's a proper noun. **Therefore, the translation means:** A MCP server that uses the C# SDK to add jokes from the JokeAPI to comments.

Tanner253

开发者工具
访问服务器

README

Comedy MCP 服务器

一个模型上下文协议 (MCP) 服务器的实现，为 AI 助手提供与喜剧相关的工具和服务。此服务器与 Cursor IDE 集成，并通过 MCP 工具提供各种与喜剧相关的功能。

概述

Comedy MCP 服务器使用 ASP.NET Core 构建，并实现模型上下文协议 (MCP)，为 AI 助手提供生成编程笑话和有趣的代码注释的工具。它充当 AI 模型和与喜剧相关的功能之间的桥梁。

MCP 服务器集成证明

功能

  • 编程笑话: 生成随机的与编程相关的笑话
  • 代码注释: 根据代码上下文和主题创建幽默的注释
  • Echo 服务: 展示日志记录功能的演示服务
  • 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    # 在 Windows 上
# OR
cp .env.example .env     # 在基于 Unix 的系统上
    • 如果需要，使用您的设置更新 .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 或配置的端口
    • 您应该看到消息“Comedy MCP Server is running!”

  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. 添加新的喜剧服务

许可证

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

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页进行交互，而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具，可以从自然语言描述生成现代化的用户界面组件，并与流行的集成开发环境（IDE）集成，从而简化用户界面开发流程。

官方
精选
本地
TypeScript
MCP Package Docs Server

MCP Package Docs Server

促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档，通过多语言支持和性能优化来增强软件开发。

精选
本地
TypeScript
Claude Code MCP

Claude Code MCP

一个实现了 Claude Code 作为模型上下文协议（Model Context Protocol, MCP）服务器的方案，它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力（代码生成、编辑、审查和文件操作）。

精选
本地
JavaScript
@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

用于任务管理的模型上下文协议服务器。它允许 Claude Desktop（或任何 MCP 客户端）在基于队列的系统中管理和执行任务。

精选
本地
JavaScript
mermaid-mcp-server

mermaid-mcp-server

一个模型上下文协议 (MCP) 服务器，用于将 Mermaid 图表转换为 PNG 图像。

精选
JavaScript
Jira-Context-MCP

Jira-Context-MCP

MCP 服务器向 AI 编码助手（如 Cursor）提供 Jira 工单信息。

精选
TypeScript
Linear MCP Server

Linear MCP Server

一个模型上下文协议（Model Context Protocol）服务器，它与 Linear 的问题跟踪系统集成，允许大型语言模型（LLM）通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

精选
JavaScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决，支持修订，并通过完整的 MCP 集成来实现多条解决方案路径。

精选
Python
Curri MCP Server

Curri MCP Server

通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要，从而实现与 Curri API 的交互。

官方
本地
JavaScript