🎭 Servidor MCP de Chistes

Un servidor de Protocolo de Contexto de Modelos (MCP) sencillo pero potente que aporta humor a las interacciones con IA. Este MCP expone la generación de chistes aleatorios como herramientas que pueden integrarse perfectamente con Claude y otros clientes compatibles con MCP.

✨ Funcionalidades

• get_random_joke - Obtener un chiste aleatorio con planteamiento y remate

• count_jokes - Obtener el número total de chistes disponibles en la base de datos

• Simple y ligero - Dependencias mínimas, ejecución rápida

• Integración fácil - Funciona con Claude Desktop y otros clientes MCP

• Bien documentado - Esquemas claros y ejemplos de uso

Related MCP server: Jokes MCP Server

🚀 Inicio rápido

Requisitos previos

• Python 3.11 o superior

• Gestor de paquetes pip

Instalación

# 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

Ejecutar el servidor

python joke-mcp.py

Deberías ver:

🚀 Joke MCP Server starting...

📖 Uso

Con Claude Desktop

Añade esto a tu archivo de configuración de Claude Desktop:

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"]
    }
  }
}

Luego reinicia Claude Desktop y ¡podrás pedirle a Claude que cuente chistes!

Referencia de la API

get_random_joke

Devuelve un chiste aleatorio con planteamiento y remate.

Entrada: Ninguna

Salida:

Setup: Why don't scientists trust atoms?

Punchline: Because they make up everything!

count_jokes

Devuelve el número total de chistes disponibles en la base de datos.

Entrada: Ninguna

Salida:

Total jokes: 5

🏗️ Estructura del proyecto

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

🔧 Detalles técnicos

Construido con

• Python 3.11+ - Lenguaje de programación

• MCP SDK v1.0.0 - Biblioteca del Protocolo de Contexto de Modelos

• Asyncio - Programación asíncrona

Cómo funciona

El servidor MCP de chistes:

1. Inicia un servidor MCP escuchando en stdio

2. Registra las herramientas disponibles con sus esquemas

3. Gestiona las solicitudes entrantes de los clientes MCP

4. Devuelve respuestas formateadas con datos de chistes

# 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

📦 Dependencias

• mcp==1.0.0 - SDK del Protocolo de Contexto de Modelos

Consulta requirements.txt para la lista completa de dependencias.

🎯 Funcionalidades actuales

✅ 5 chistes integrados ✅ Soporte de async/await ✅ Manejo limpio de errores ✅ Definición sencilla de herramientas basada en esquemas ✅ Registro en stdout

🔮 Mejoras futuras

• Añadir categorías de chistes (chistes de padre, juegos de palabras, humor negro)

• Implementar niveles de dificultad

• Añadir valoraciones/comentarios de chistes

• Conectar con APIs externas de chistes

• Guardar los favoritos del usuario

• Soporte multilingüe

• Interfaz web para la gestión de chistes

🤝 Contribuciones

No dudes en:

• Añadir más chistes a la base de datos

• Mejorar la documentación

• Informar de errores

• Sugerir nuevas funciones

📝 Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.

🔗 Enlaces

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

• Especificación de MCP: https://spec.modelcontextprotocol.io/

• Documentación de MCP de Anthropic: https://modelcontextprotocol.io/

💡 Ejemplos de casos de uso

1. Integración con asistentes de IA - Añade humor a las interacciones con Claude

2. Bot de Slack - Integra chistes en la comunicación del equipo

3. Herramienta de aprendizaje - Comprende los conceptos básicos de la implementación de MCP

4. Plantilla - Úsalo como punto de partida para tus propios servidores MCP

🐛 Solución de problemas

Problema: Error de módulo no encontrado

pip install -r requirements.txt

Problema: Puerto ya en uso El servidor usa stdio, no un puerto. Esto no debería ocurrir.

Problema: El servidor no arranca

• Comprueba la versión de Python (3.11+)

• Verifica que todas las dependencias estén instaladas

• Comprueba si hay errores de sintaxis

📧 Soporte

Para problemas, preguntas o sugerencias, abre un issue en GitHub.