Joke Generator MCP

Un servidor simple del Model Context Protocol (MCP) construido con Python que proporciona chistes para desarrolladores y de programación.

Objetivo

Este proyecto se ha creado como parte de un flujo de aprendizaje de MCP para entender cómo se estructuran, prueban y despliegan los servidores MCP.

Related MCP server: Jokes MCP Server

Características

• Herramientas:

  • get_random_joke: Devuelve un chiste aleatorio para desarrolladores.

  • get_joke_by_topic: Devuelve un chiste basado en un tema de programación específico (por ejemplo, Python, JavaScript, CSS).

Configuración e instalación

1. Clona o descarga el repositorio

2. Instala las dependencias: Asegúrate de tener Python 3.10+ instalado. Instala el paquete localmente:

   pip install -e .

Uso (pruebas locales)

Puedes ejecutar el servidor MCP directamente usando stdio:

python -m joke_mcp

Pruebas con el MCP Inspector

Para probar el servidor de forma interactiva, usa el MCP Inspector oficial:

npx @modelcontextprotocol/inspector python -m joke_mcp

Esto iniciará una interfaz web local donde podrás invocar las herramientas proporcionadas por este servidor.

Despliegue en Smithery

Este proyecto incluye un archivo de configuración smithery.yaml para facilitar el despliegue en el mercado de Smithery.

1. Asegúrate de que tu código esté alojado en un repositorio público de GitHub.

2. Ve a Smithery y haz clic en "Add Server".

3. Proporciona la URL de tu repositorio. Smithery leerá el smithery.yaml y configurará la compilación automáticamente.

Resultados de aprendizaje

• Se demostró cómo usar el SDK de Python mcp para crear herramientas.

• Se configuró una estructura estándar de paquete de Python.

• Se preparó para compartir públicamente a través de un mercado de MCP.