Joke Generator MCP

Ein einfacher Model Context Protocol (MCP)-Server, der mit Python erstellt wurde und Entwickler- und Programmierwitze bereitstellt.

Ziel

Dieses Projekt wurde im Rahmen eines MCP-Lernworkflows erstellt, um zu verstehen, wie MCP-Server strukturiert, getestet und bereitgestellt werden.

Related MCP server: Jokes MCP Server

Funktionen

• Tools:

  • get_random_joke: Gibt einen zufälligen Entwicklerwitz zurück.

  • get_joke_by_topic: Gibt einen Witz basierend auf einem bestimmten Programmierthema zurück (z. B. Python, JavaScript, CSS).

Einrichtung & Installation

1. Repository klonen oder herunterladen

2. Abhängigkeiten installieren: Stellen Sie sicher, dass Python 3.10+ installiert ist. Installieren Sie das Paket lokal:

   pip install -e .

Verwendung (Lokaler Test)

Sie können den MCP-Server direkt mit stdio ausführen:

python -m joke_mcp

Testen mit dem MCP Inspector

Um den Server interaktiv zu testen, verwenden Sie den offiziellen MCP Inspector:

npx @modelcontextprotocol/inspector python -m joke_mcp

Dies startet eine lokale Web-Oberfläche, über die Sie die von diesem Server bereitgestellten Tools aufrufen können.

Bereitstellung auf Smithery

Dieses Projekt enthält eine smithery.yaml-Konfigurationsdatei für eine einfache Bereitstellung im Smithery-Marktplatz.

1. Stellen Sie sicher, dass Ihr Code in einem öffentlichen GitHub-Repository gehostet wird.

2. Gehen Sie zu Smithery und klicken Sie auf „Add Server“.

3. Geben Sie die URL Ihres Repositorys an. Smithery liest die smithery.yaml und konfiguriert den Build automatisch.

Lernergebnisse

• Demonstriert, wie das mcp Python SDK verwendet wird, um Tools zu erstellen.

• Eine standardmäßige Python-Paketstruktur eingerichtet.

• Für die öffentliche Freigabe über einen MCP-Marktplatz vorbereitet.