README Documentation
Chuck Norris Jokes MCP Server
Este es un servidor MCP (Model Context Protocol) simple que expone una herramienta para obtener chistes aleatorios de Chuck Norris utilizando la API pública de Chuck Norris.
Características
- Herramienta
chistecitos
que devuelve chistes aleatorios de Chuck Norris - Implementación asíncrona para mejor rendimiento
- Manejo de errores integrado
- Interfaz simple y fácil de usar
Requisitos
- Python 3.9 o superior
- pip (gestor de paquetes de Python)
Instalación
- Clona este repositorio:
git clone <url-del-repositorio>
cd jokes-mcp
- Instala las dependencias:
pip install -r requirements.txt
Uso
- Inicia el servidor:
python server.py
- El servidor expondrá la herramienta
chistecitos
que puede ser utilizada por cualquier cliente MCP compatible.
Ejemplo de Uso
La herramienta chistecitos
puede ser llamada sin parámetros y devolverá un chiste aleatorio de Chuck Norris. Por ejemplo:
# Ejemplo de respuesta
"Chuck Norris puede dividir por cero."
Tecnologías Utilizadas
- MCP Python SDK - Para la implementación del servidor MCP
- httpx - Cliente HTTP asíncrono para Python
- Chuck Norris API - API pública para obtener chistes de Chuck Norris
Contribuir
Las contribuciones son bienvenidas. Por favor, abre un issue para discutir los cambios propuestos o envía un pull request.
Licencia
Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE
para más detalles.
Quick Actions
Key Features
Model Context Protocol
Secure Communication
Real-time Updates
Open Source