🎭 Joke MCP Server

Ein einfacher, aber leistungsstarker Model Context Protocol (MCP)-Server, der Humor in KI-Interaktionen bringt. Dieser MCP stellt die Generierung zufälliger Witze als Tools bereit, die nahtlos in Claude und andere MCP-kompatible Clients integriert werden können.

✨ Funktionen

• get_random_joke – Einen zufälligen Witz mit Einleitung und Pointe erhalten

• count_jokes – Die Gesamtzahl der verfügbaren Witze in der Datenbank abrufen

• Einfach & leichtgewichtig – Minimale Abhängigkeiten, schnelle Ausführung

• Einfache Integration – Funktioniert mit Claude Desktop und anderen MCP-Clients

• Gut dokumentiert – Klare Schemata und Verwendungsbeispiele

Related MCP server: Jokes MCP Server

🚀 Schnellstart

Voraussetzungen

• Python 3.11 oder höher

• pip-Paketmanager

Installation

# Clone the repository
git clone https://github.com/tehrimaly/mcp-joke.git
cd mcp-joke

# Create virtual environment
python -m venv venv

# Activate virtual environment
# On Windows:
venv\Scripts\Activate.ps1
# On macOS/Linux:
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

Server ausführen

python joke-mcp.py

Sie sollten Folgendes sehen:

🚀 Joke MCP Server starting...

📖 Verwendung

Mit Claude Desktop

Fügen Sie dies zu Ihrer Claude-Desktop-Konfigurationsdatei hinzu:

macOS/Linux: ~/.config/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "joke-mcp": {
      "command": "python",
      "args": ["/path/to/joke-mcp.py"]
    }
  }
}

Starten Sie dann Claude Desktop neu und Sie können Claude bitten, Witze zu erzählen!

API-Referenz

get_random_joke

Gibt einen zufälligen Witz mit Einleitung und Pointe zurück.

Eingabe: Keine

Ausgabe:

Setup: Why don't scientists trust atoms?

Punchline: Because they make up everything!

count_jokes

Gibt die Gesamtzahl der in der Datenbank verfügbaren Witze zurück.

Eingabe: Keine

Ausgabe:

Total jokes: 5

🏗️ Projektstruktur

mcp-joke/
├── joke-mcp.py          # Main MCP server implementation
├── requirements.txt      # Python dependencies
├── README.md            # This file
├── .gitignore           # Git configuration
└── LICENSE              # MIT License

🔧 Technische Details

Erstellt mit

• Python 3.11+ – Programmiersprache

• MCP SDK v1.0.0 – Model Context Protocol-Bibliothek

• Asyncio – Asynchrone Programmierung

So funktioniert es

Der Joke MCP Server:

1. Startet einen MCP-Server, der auf stdio lauscht

2. Registriert verfügbare Tools mit ihren Schemata

3. Verarbeitet eingehende Anfragen von MCP-Clients

4. Gibt formatierte Antworten mit Witzdaten zurück

# Tool registration example
@server.list_tools()
async def list_tools():
    return [
        Tool(
            name="get_random_joke",
            description="Get a random joke",
            inputSchema={...}
        )
    ]

# Tool execution
@server.call_tool()
async def call_tool(name: str, arguments: dict):
    if name == "get_random_joke":
        # Return random joke

📦 Abhängigkeiten

• mcp==1.0.0 – Model Context Protocol SDK

Die vollständige Liste der Abhängigkeiten finden Sie in requirements.txt.

🎯 Aktuelle Funktionen

✅ 5 eingebaute Witze ✅ Async/await-Unterstützung ✅ Saubere Fehlerbehandlung ✅ Einfache schemabasierte Tool-Definition ✅ Stdout-Protokollierung

🔮 Zukünftige Erweiterungen

• Witzkategorien hinzufügen (Vaterwitze, Wortspiele, schwarzer Humor)

• Schwierigkeitsgrade implementieren

• Witzbewertungen/-feedback hinzufügen

• Verbindung zu externen Witz-APIs herstellen

• Benutzerfavoriten speichern

• Mehrsprachige Unterstützung

• Weboberfläche für die Witzverwaltung

🤝 Mitwirken

Sie können gerne:

• Weitere Witze zur Datenbank hinzufügen

• Die Dokumentation verbessern

• Fehler melden

• Neue Funktionen vorschlagen

📝 Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – siehe LICENSE-Datei für Details.

🔗 Links

• GitHub: https://github.com/tehrimaly/mcp-guide

• MCP-Spezifikation: https://spec.modelcontextprotocol.io/

• Anthropic MCP-Dokumentation: https://modelcontextprotocol.io/

💡 Beispielhafte Anwendungsfälle

1. KI-Assistenten-Integration – Humor in Claude-Interaktionen einbringen

2. Slack-Bot – Witze in die Teamkommunikation integrieren

3. Lernwerkzeug – Grundlagen der MCP-Implementierung verstehen

4. Vorlage – Als Ausgangspunkt für eigene MCP-Server verwenden

🐛 Fehlerbehebung

Problem: Modul nicht gefunden

pip install -r requirements.txt

Problem: Port bereits belegt Der Server verwendet stdio, keinen Port. Dies sollte nicht auftreten.

Problem: Server startet nicht

• Python-Version prüfen (3.11+)

• Alle Abhängigkeiten installiert überprüfen

• Auf Syntaxfehler prüfen

📧 Support

Bei Problemen, Fragen oder Anregungen öffnen Sie bitte ein GitHub-Issue.