aamangeldi-dad-jokes-mcp
Get a random dad joke or search by keyword to fit any moment. Retrieve specific jokes by ID for re鈥�
可用工具 （5 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
tavily_search 14 个参数 需填 1 项
Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.
必填参数：query
tavily_extract 6 个参数 需填 1 项
Extract content from URLs. Returns raw page content in markdown or text format.
必填参数：urls
tavily_crawl 11 个参数 需填 1 项
Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.
必填参数：url
tavily_map 8 个参数 需填 1 项
Map a website's structure. Returns a list of URLs found starting from the base URL.
必填参数：url
tavily_research 2 个参数 需填 1 项
Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.
必填参数：input
服务介绍
Dad Jokes MCP Server
A lightweight Model Context Protocol (MCP) server that provides dad jokes from icanhazdadjoke.com.
# Features
- 🎭 Get random dad jokes
- 🔍 Search jokes by keyword
- 🆔 Retrieve specific jokes by ID
- ⚡ Fast and lightweight
- 🚀 Ready for Smithery deployment
# Tools
# # get_random_joke_tool
Get a random dad joke.
Example:
{}
# # search_jokes_tool
Search for dad jokes containing a specific term.
Parameters:
term(string, required): Search term to find jokeslimit(integer, optional): Number of jokes to return (default: 5, max: 30)
Example:
{
"term": "pizza",
"limit": 3
}
# # get_joke_by_id_tool
Retrieve a specific joke by its ID.
Parameters:
joke_id(string, required): The ID of the joke to retrieve
Example:
{
"joke_id": "R7UfaahVfFd"
}
# Local Development
# # Prerequisites
- Python 3.11+
- pip
# # Setup
- Clone the repository:
git clone https://github.com/aamangeldi/dad-jokes-mcp.git
cd dad-jokes-mcp
- Create a virtual environment and install dependencies:
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
pip install fastmcp smithery httpx
- Run the server locally:
fastmcp run server.py
# Deployment to Smithery
- Push your code to GitHub
- Connect your repository to Smithery
- Smithery will automatically detect the configuration and deploy your server
The server uses:
runtime: pythoninsmithery.yaml- FastMCP for the server implementation
@smithery.server()decorator for configuration
# Configuration
The server requires no authentication or configuration. It uses the free icanhazdadjoke.com API with the following defaults:
- API:
https://icanhazdadjoke.com - No API key required
- Rate limiting follows icanhazdadjoke.com policies
# Credits
Dad jokes provided by icanhazdadjoke.com
# License
MIT License - see LICENSE file for details
