mcpField
A
aamangeldi-dad-jokes-mcp

aamangeldi-dad-jokes-mcp

远程服务
github.com/aamangeldi游戏娱乐056 周前更新
代码仓库

关于 aamangeldi-dad-jokes-mcp

这是一个从 icanhazdadjoke.com 提供冷笑话的轻量 MCP 服务，支持随机获取、关键词搜索和按笑话 ID 查询，适用于需要笑话内容的应用或 Agent。

主要功能

  1. 01获取随机冷笑话
  2. 02按关键词搜索笑话
  3. 03按 ID 获取笑话
  4. 04无需 API 密钥

适用场景

  1. 01在日常对话中请求笑话
  2. 02查找与关键词相关的笑话
  3. 03按 ID 获取指定笑话

MCP 相关

向 MCP 客户端提供随机获取、按关键词搜索和按 ID 查询笑话的工具。笑话内容来自 icanhazdadjoke.com。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://server.smithery.ai/@aamangeldi/dad-jokes-mcp/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址
Streamable HTTPhttps://server.smithery.ai/@aamangeldi/dad-jokes-mcp/mcp需要授权

工具

详细介绍

Dad Jokes MCP 服务

smithery badge

一个轻量级的 Model Context Protocol（MCP）服务，可从 icanhazdadjoke.com 获取冷笑话。

功能

  • 🎭 获取随机冷笑话
  • 🔍 按关键词搜索笑话
  • 🆔 按 ID 获取特定笑话
  • ⚡ 快速轻量
  • 🚀 可直接部署到 Smithery

工具

get_random_joke_tool

获取随机冷笑话。

示例：

{}
search_jokes_tool

搜索包含特定词语的冷笑话。

参数：

  • term（字符串，必填）：用于查找笑话的搜索词
  • limit（整数，可选）：返回的笑话数量（默认值：5，最大值：30）

示例：

{
  "term": "pizza",
  "limit": 3
}
get_joke_by_id_tool

按 ID 获取特定笑话。

参数：

  • joke_id（字符串，必填）：要获取的笑话 ID

示例：

{
  "joke_id": "R7UfaahVfFd"
}

本地开发

先决条件
  • Python 3.11+
  • pip
设置
  1. 克隆仓库：
git clone https://github.com/aamangeldi/dad-jokes-mcp.git
cd dad-jokes-mcp
  1. 创建虚拟环境并安装依赖：
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install fastmcp smithery httpx
  1. 在本地运行服务：
fastmcp run server.py

部署到 Smithery

  1. 将代码推送到 GitHub
  2. 将仓库连接到 Smithery
  3. Smithery 会自动检测配置并部署服务

该服务使用：

  • smithery.yaml 中的 runtime: python
  • FastMCP 实现服务
  • 用于配置的 @smithery.server() 装饰器

配置

该服务无需身份验证或配置。它使用免费的 icanhazdadjoke.com API，默认设置如下：

  • API：https://icanhazdadjoke.com
  • 无需 API 密钥
  • 速率限制遵循 icanhazdadjoke.com 的政策

致谢

冷笑话由 icanhazdadjoke.com 提供

许可证

MIT 许可证——详情请参阅 LICENSE 文件

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。