项目简介

这是一个基于Model Context Protocol (MCP) 实现的服务器，专注于提供多种获取笑话的工具。它使用了MCP的Streamable HTTP传输协议，允许通过标准的HTTP POST请求接收并处理MCP指令。

主要功能点

本服务器提供了以下几个工具，供MCP客户端调用：

• 获取随机查克·诺里斯（Chuck Norris）笑话：调用后返回一个随机的查克·诺里斯笑话。
• 按类别获取随机查克·诺里斯笑话：调用时需要提供一个笑话类别（如"dev"），服务器将返回该类别下的一个随机查克·诺里斯笑话。
• 获取所有可用的查克·诺里斯笑话类别列表：调用后返回所有支持的查克·诺里斯笑话类别。
• 获取随机“老爸笑话”（Dad joke）：调用后返回一个随机的“老爸笑话”。

安装步骤

1. 确保你已安装 Node.js (推荐 v22 或更高版本) 和 npm。
2. 克隆仓库到本地：在终端运行 'git clone https://github.com/Laskewitz/MCP-Streamable-HTTP.git'。
3. 进入项目目录：'cd MCP-Streamable-HTTP'。
4. 安装项目依赖：运行 'npm install'。
5. 编译并启动服务器：运行 'npm run build && npm run start'。服务器将启动并监听配置的端口（默认是 3000）。

服务器配置（供MCP客户端参考）

对于兼容的MCP客户端应用，通常需要知道如何连接到这个服务器。这个服务器实现了MCP的Streamable HTTP传输协议。客户端在配置与本服务器的连接时，可能需要以下信息：

• server name: 服务器的标识名称，本服务器设置为 'mcp-streamable-http'。
• command: 如果客户端需要启动服务器进程，此参数指定启动命令。对于这个Node.js项目，启动命令通常是 'npm'。
• args: 传递给启动命令的参数。对于这个项目，通常是 '["start"]'，即运行 'npm start'。

请注意，如果你的MCP客户端是通过网络地址连接一个已经运行的HTTP服务器，你可能需要提供服务器的完整URL和路径，例如 'http://服务器地址:端口/mcp'，而不是 'command' 和 'args'。具体的配置方式请参考你的MCP客户端文档。

基本使用方法

服务器启动后，它会在指定的端口上监听 '/mcp' 路径的 HTTP POST 请求。一个支持MCP协议的客户端应用可以连接到这个服务器地址。连接成功后，客户端可以发现服务器提供的所有工具（即上面提到的各种笑话工具），并向服务器发送调用请求，以获取笑话或相关信息。服务器会通过标准的JSON-RPC响应返回结果。