Dad Jokes MCP Server

🎭 A professional Model Context Protocol (MCP) server that brings premium dad jokes to your AI workflow! Perfect for breaking the ice, lightening the mood, or just adding some wholesome humor to your development environment.

🚀 Quick Start

Installation

# Using npx (recommended - no installation needed)
npx dad-jokes-mcp-server

# Or install globally
npm install -g dad-jokes-mcp-server
dad-jokes-mcp-server

# Or install locally
npm install dad-jokes-mcp-server

MCP Client Configuration

Add this to your MCP client configuration:

Claude Desktop / Cline / Cursor:

{
  "mcpServers": {
    "dad-jokes": {
      "command": "npx",
      "args": ["-y", "dad-jokes-mcp-server"]
    }
  }
}

Alternative (if installed globally):

{
  "mcpServers": {
    "dad-jokes": {
      "command": "dad-jokes-mcp-server"
    }
  }
}

🎯 Features

🎭 Joke Generation

• Topic-based jokes: Generate jokes about any subject
• Multiple styles: Classic, punny, wholesome, groan-worthy
• Random jokes: Get 1-5 random jokes at once
• Quality rating: Rate jokes and get professional feedback

🛠️ Tools & Utilities

• Category browser: Explore 20+ joke categories
• Statistics: Fun facts about dad jokes
• Joke of the day: Daily curated humor
• Professional prompts: Ready-to-use joke generation

🏢 Professional Features

• TypeScript: Full type safety and modern code
• CLI interface: Easy to use from command line
• Help system: Built-in documentation
• Error handling: Robust and reliable
• NPM optimized: Easy installation and distribution

📋 Available Prompts

generate-dad-joke

Generate a joke on any topic with style options.

Parameters:

• topic (string): Subject for the joke (e.g., "programming", "coffee", "cats")
• style (optional): "classic", "punny", "wholesome", or "groan-worthy"

Example:

{
  "topic": "TypeScript",
  "style": "punny"
}

random-dad-joke

Get random jokes for instant humor.

Parameters:

• count (optional): Number of jokes (1-5)

rate-dad-joke

Professional joke evaluation and feedback.

Parameters:

• joke (string): The joke to rate

🛠️ Available Tools

| Tool | Description | |------|-------------| | get-joke-categories | Browse 20+ available categories | | joke-stats | Fun statistics about dad jokes | | joke-of-the-day | Daily curated joke with date |

💡 Usage Examples

Basic Joke Generation

# In your MCP client:
"Tell me a programming joke"
# Uses: generate-dad-joke with topic="programming"

Random Team Humor

"Give me 3 random dad jokes for our standup"
# Uses: random-dad-joke with count="3"

Joke Quality Control

"Rate this joke: Why do programmers prefer dark mode? Because light attracts bugs!"
# Uses: rate-dad-joke

Browse Categories

"What joke categories are available?"
# Uses: get-joke-categories tool

🎯 Perfect For

• 🏢 Team Building: Break the ice in meetings
• 💻 Development: Lighten code review comments
• 📚 Documentation: Add personality to technical docs
• 🤖 AI Assistants: Enhance chatbot personalities
• 🎮 Slack Bots: Automated humor for team channels
• 📖 Content Creation: Engaging social media content

🔧 CLI Usage

# Start the MCP server
dad-jokes-mcp-server

# Show help
dad-jokes-mcp-server --help

# Show version
dad-jokes-mcp-server --version

🏗️ Technical Details

System Requirements

• Node.js: >= 18.0.0
• NPM: Latest version recommended
• MCP Client: Claude Desktop, Cline, Cursor, or compatible

Transport

• Protocol: Model Context Protocol (MCP)
• Transport: stdio (standard input/output)
• Format: JSON-RPC 2.0

Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   MCP Client    │◄──►│ Dad Jokes Server │◄──►│  Joke Engine    │
│ (Claude/Cline)  │    │   (This Package) │    │   (AI Prompts)  │
└─────────────────┘    └──────────────────┘    └─────────────────┘

🧪 Development

Local Development

# Clone the repository
git clone https://github.com/OrenGrinker/dad-jokes-mcp-server.git
cd dad-jokes-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Test locally
npm run test:local

Testing the Package

# Test with different MCP clients
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}' | dad-jokes-mcp-server

📦 What's Included

dad-jokes-mcp-server/
├── bin/dad-jokes-mcp       # Executable CLI script
├── dist/                   # Compiled TypeScript
│   ├── index.js           # Main server code
│   ├── index.d.ts         # Type definitions
│   └── index.js.map       # Source maps
├── package.json           # NPM package config
├── README.md             # This file
└── LICENSE               # MIT license

🤝 Contributing

We welcome contributions! Here's how:

1. 🍴 Fork the repository
2. 🌟 Create a feature branch: git checkout -b feature/amazing-jokes
3. 💻 Code your improvements
4. ✅ Test your changes: npm run build && npm run test:local
5. 📤 Submit a pull request

Contribution Ideas

• 🎭 New joke categories
• 🛠️ Additional tools
• 🌐 Internationalization
• 🧪 Test coverage
• 📚 Documentation improvements

📊 Package Stats

• 📦 Bundle Size: < 100KB
• ⚡ Startup Time: < 500ms
• 🎯 Compatibility: All major MCP clients
• 🔒 Dependencies: Minimal & secure
• 📈 Performance: Optimized for speed

🆘 Troubleshooting

Common Issues

1. "Command not found"

   # Ensure global installation or use npx
   npm install -g dad-jokes-mcp-server
   # or
   npx dad-jokes-mcp-server

2. "Built files not found"

   # Package may need rebuilding
   npm run build

3. MCP connection issues

   • Verify Node.js version >= 18.0.0
   • Check MCP client configuration syntax
   • Ensure server starts without errors

Getting Help

• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📧 Contact: Open an issue for support

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• 🤖 Anthropic - For the Model Context Protocol
• 👨‍💻 Dad joke community - For endless inspiration
• 🌟 Contributors - Making this project better
• 😄 Every developer who appreciates a good (bad) pun

📈 Changelog

v1.0.0

• 🎉 Initial release
• ✨ Core joke generation features
• 🛠️ Professional MCP server implementation
• 📦 NPM package optimization
• 📚 Comprehensive documentation

"A day without laughter is a day wasted, but a day with dad jokes is a day where everyone groans together!" 😄

Made with ❤️ by OrenGrinker

⭐ Star this repo if it made you smile! ⭐