Dad Jokes

Provides dad joke generation, topic-based prompts, random jokes, ratings, and category browsing via MCP.

typescript

2

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "orengrinker-dad-jokes-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/dad-jokes-mcp-server/dist/index.js"
      ],
      "env": {
        "DEBUG": "true",
        "LOG_LEVEL": "info"
      }
    }
  }
}

You run a specialized MCP server that generates and manages dad jokes through the Model Context Protocol. It provides multiple joke styles, topic-based generation, random jokes, ratings, category browsing, and fun statistics, all with type safety and a clean, maintainable architecture. This server helps you add lighthearted humor to code reviews, standups, or any developer workflow while integrating with MCP clients.

How to use

You interact with the Dad Jokes MCP Server through MCP-compatible clients. Start the server locally, then connect your MCP client to the running process. Use the available prompts to generate jokes on topics you care about, fetch random jokes for inspiration, browse joke categories, and rate jokes to receive feedback. When you craft prompts, you can target specific styles like classic, punny, wholesome, or groan-worthy to fit the moment.

How to install

Prerequisites: Ensure Node.js is installed (version 18 or newer) and you have npm or yarn available. Basic TypeScript knowledge is helpful but not required for running the server.

Step-by-step installation and startup flow:

Install dependencies and build the project locally.
Start the MCP server so it is ready to accept MCP client connections.

Configuration and runtime notes

You can connect MCP clients via the provided stdio-based invocation. The recommended local runtime example shows how to run the server as a standard Node process using a direct path to the built script.

{
  "mcpServers": {
    "dad_jokes": {
      "command": "node",
      "args": ["/path/to/dad-jokes-mcp-server/dist/index.js"],
      "env": {}
    }
  }
}

Troubleshooting

If you encounter issues starting the server, verify you are running Node.js version 18 or newer, confirm the path to the built script exists, and ensure the dist directory is present after the build step.

Available tools

generate-dad-joke

Generate a dad joke on a specific topic with an optional style (classic, punny, wholesome, groan-worthy) and receive the resulting joke.

random-dad-joke

Generate one or more random dad jokes to spark inspiration or lighten the mood.

rate-dad-joke

Provide a joke string to receive a professional rating and feedback, helping you improve joke quality.

get-joke-categories

Retrieve all available joke categories to explore different topics for joke generation.

joke-stats

Return fun statistics about dad jokes, such as popularity metrics and groan times.