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