Skip to main content
Glama
deenesjakoruzh
aidevshakil

Joke Generator MCP

by aidevshakil
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
Python
Hybrid

Joke Generator MCP

A simple Model Context Protocol (MCP) server built with Python that provides developer and programming jokes.

Objective

This project is built as part of an MCP learning workflow to understand how MCP servers are structured, tested, and deployed.

Related MCP server: Jokes MCP Server

Features

  • Tools:

    • get_random_joke: Returns a random developer joke.

    • get_joke_by_topic: Returns a joke based on a specific programming topic (e.g., Python, JavaScript, CSS).

Setup & Installation

  1. Clone or Download the Repository

  2. Install Dependencies: Ensure you have Python 3.10+ installed. Install the package locally:

    pip install -e .

Usage (Local Testing)

You can run the MCP server directly using stdio:

python -m joke_mcp

Testing with the MCP Inspector

To interactively test the server, use the official MCP Inspector:

npx @modelcontextprotocol/inspector python -m joke_mcp

This will start a local web interface where you can invoke the tools provided by this server.

Deployment to Smithery

This project includes a smithery.yaml configuration file for easy deployment to the Smithery marketplace.

  1. Ensure your code is hosted on a public GitHub repository.

  2. Go to Smithery and click "Add Server".

  3. Provide your repository URL. Smithery will read the smithery.yaml and configure the build automatically.

Learning Outcomes

  • Demonstrated how to use the mcp Python SDK to create tools.

  • Set up a standard Python package structure.

  • Prepared for public sharing via an MCP marketplace.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • Jokes MCP Server

    tructranthanh
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables users to fetch jokes from various categories including Chuck Norris and dad jokes through a standardized MCP interface. Demonstrates integration between Microsoft Copilot Studio and MCP servers for humor-based interactions.
    MIT

  • Jokes MCP Server

    Louie63
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables users to fetch various types of jokes including Chuck Norris and Dad jokes through an MCP server that integrates with Microsoft Copilot Studio and GitHub Copilot.
    MIT

  • Jokes MCP Server

    Durgam58
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables users to fetch jokes from various categories including Chuck Norris jokes and Dad jokes through a standardized MCP interface. Provides integration with Microsoft Copilot Studio and GitHub Copilot for AI-powered humor delivery.
    MIT

  • Jokes MCP Server

    btomartelli
    A
    license
    Not graded
    quality
    D
    maintenance
    Fetches jokes from multiple APIs including Chuck Norris, Dad jokes, and Yo Mama jokes, providing humor-focused content through standardized MCP tools.
    MIT