Huuh MCP Server

Se integra con la plataforma huuh.me para habilitar bases de conocimiento y personas de IA colaborativas.

Documentación

🚀 Huuh MCP Server - ¡IA colaborativa para todos! 🎓

El Huuh MCP Server es tu servidor de Protocolo de Contexto de Modelo (MCP) amigable que conecta las aplicaciones de IA con la plataforma huuh.me 🤖💝

Con huuh.me puedes:

📚 Conocimiento nativo para IA
- crear bases de conocimiento
- recuperar y contribuir contenido directamente en el chat
🫂 IA compartida para tu equipo
- compartir y colaborar en bases de conocimiento con otros
- permitirles recuperar y contribuir
🎭 mejores resultados con uso flexible
- Crea y comparte personas de IA (prompts de sistema)
- cambia de tu IA de Investigación a tu IA de Marketing directamente en el chat

✨ ¿Qué hace este servidor?

Nuestro servidor es como una navaja suiza para la colaboración en la era de la IA! 🔧📚 Puedes:

🔍 Explorar bases: Busca en las bases de conocimiento públicas del marketplace
📖 Acceder a información: Recupera información específica de una de tus bases o de cualquier base pública
🎭 Gestionar personas: Obtén y actualiza personas de IA para aplicar rápidamente prompts de sistema en el chat
📝 Contribuir contenido: Añade tus propias contribuciones a las bases y ayuda a construir la base de conocimiento
🛠️ Contribuir personas: Contribuye con personas que encuentres útiles a una base pública
🏗️ Crear bases: Inicia nuevas bases de conocimiento para tus proyectos
🔗 Asignar bases a espacios: Comparte bases con tu equipo o espacio de trabajo
🌟 Crear espacios: Configura espacios colaborativos para el trabajo en equipo

Para usar el servidor, por favor regístrate en la plataforma huuh.me y obtén tu clave de API. Este servidor está diseñado para funcionar con la API de huuh, ¡así que necesitarás una cuenta para empezar! 🌐

🛠️ Herramientas disponibles - ¡Tu caja de herramientas de IA!

¡Nuestro servidor viene con 10 herramientas increíbles que hacen que trabajar con contenido educativo sea muy fácil!

1. 🏠 `get_user_options`

Qué hace: Obtiene información sobre tus bases, módulos y archivos disponibles
Perfecto para: Comenzar tu viaje y entender qué tienes disponible!

2. 🛒 `search_marketplace`

Qué hace: Busca bases en el marketplace
Parámetros:

query (cadena) - Tus términos de búsqueda (máximo 150 caracteres)
Perfecto para: Descubrir nuevas bases y oportunidades educativas!

3. 🔍 `retrieve_information`

Qué hace: Recupera información específica del contenido de la base
Parámetros:

query (cadena) - Lo que estás buscando (máximo 150 caracteres)
base_id (cadena) - En qué base buscar
relevant_blocks (matriz, opcional) - Módulos específicos en los que enfocarse
relevant_groups (matriz, opcional) - Grupos específicos a incluir
relevant_file_ids (matriz, opcional) - Archivos específicos a buscar
Perfecto para: Obtener respuestas precisas de los materiales de la base!

4. 📝 `contribute`

Qué hace: Añade tus propias contribuciones de contenido a las bases
Parámetros:

base_id (cadena) - Base a la que contribuir
folder_number (cadena) - En qué carpeta añadir contenido
contribution_title (cadena) - Título de tu contribución
contribution_content (cadena) - Tu increíble contenido (máximo 30,000 caracteres)
Perfecto para: Compartir conocimiento y ayudar a otros a aprender!

5. 🎭 `get_persona`

Qué hace: Recupera información sobre personas de IA
Parámetros:

title (cadena) - Nombre de la persona que deseas
Perfecto para: Aplicar tus prompts de sistema guardados en tu chat!

6. 🔄 `refresh_persona`

Qué hace: Actualiza el contenido y comportamiento de la persona
Parámetros:

title (cadena) - Persona a actualizar
new_content (cadena) - Contenido actualizado de la persona
base_id (cadena, opcional) - Actualizaciones de persona específicas de la base
Perfecto para: Mejorar iterativamente los prompts de sistema para uso futuro!

7. 🎁 `contribute_persona_to_base`

Qué hace: Añade una persona completamente nueva a una base (tuya o pública) Parámetros:

base_id (cadena) - Base a la que añadir la persona
persona_title (cadena) - Nombre de tu nueva persona
persona_content (cadena) - Descripción y comportamiento de la persona (máximo 150 caracteres)
Perfecto para: Guardar prompts de sistema para reaplicarlos en el futuro!

8. 🏗️ `create_base`

Qué hace: Crea una nueva base de conocimiento para tu contenido Parámetros:

base_name (cadena) - Nombre de tu nueva base
base_description (cadena) - Descripción de sobre qué trata la base
Perfecto para: Iniciar bases de conocimiento nuevas para temas o proyectos nuevos!

9. 🔗 `assign_base_to_space`

Qué hace: Asigna una base existente a un espacio colaborativo Parámetros:

space_id (cadena) - ID del espacio al que asignar la base
base_id (cadena) - ID de la base a asignar
Perfecto para: Compartir bases con tu equipo o espacio de trabajo!

10. 🌟 `create_spaces`

Qué hace: Crea un nuevo espacio colaborativo para trabajo en equipo Parámetros:

space_name (cadena) - Nombre de tu nuevo espacio
space_description (cadena) - Descripción del propósito del espacio
Perfecto para: Configurar entornos colaborativos para equipos y proyectos!

🚀 Inicio rápido - ¡Ponte en marcha en segundos!

Instalación mediante Smithery

Para instalar mcp para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @infolab-ai/mcp --client claude

Configuración de Claude Desktop

Añade la siguiente configuración a claude-desktop.json:

{
  "mcpServers": {
    "huuh-mcp": {
      "command": "uvx",
      "args": ["huuh-mcp"],
      "env": {
        "HUUH_APIK_KEY": "<yours>"
      }
    }
  }
}

🔧 Configuración de desarrollo - ¡Para los entusiastas del código!

¿Quieres contribuir o personalizar? ¡Nos encantan los desarrolladores! 💻❤️

Requisitos previos

Python 3.12+ 🐍
Gestor de paquetes uv ⚡

Pasos de configuración

# Clone the repository
git clone https://github.com/infolab-ai/mcp.git
cd mcp

# Install dependencies with uv (it's lightning fast!)
uv sync

# Activate the virtual environment
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Set up your environment variables
cp .env.sample .env
# Edit .env with your API credentials

# Run the server in development mode
uv --directory path/to/huuh_mcp -m huuh_mcp.server --env-file /path/to/.env

Variables de entorno 📋

Crea un archivo .env con:

# Your HUUH API key (get this from your account settings)
HUUH_APIK_KEY=your_api_key_here

# Optional: Set logging level
LOG_LEVEL=INFO

🔐 Autenticación - ¡Segura y simple!

El servidor utiliza autenticación con clave de API para mantener tus datos seguros! 🛡️

🔑 Obtén tu clave de API de la plataforma huuh.me
🔒 Configúrala en tus variables de entorno
✨ ¡El servidor se encarga del resto automáticamente!

📜 Licencia - ¡Libertad para aprender y construir!

Este proyecto está licenciado bajo la Licencia MIT 📄 - lo que significa que eres libre de:

✅ Usarlo comercialmente
✅ Modificarlo como quieras
✅ Distribuirlo a otros
✅ Usarlo de forma privada
✅ Contribuir de vuelta a la comunidad

¿El único requisito? Mantener el aviso de licencia en trabajos derivados. ¡Eso es todo! 🎉

🤝 Contribuciones - ¡Únete a nuestra comunidad de Discord!

¡Nos encantaría tu ayuda para hacer este servidor aún más increíble! 🌟

🐛 ¿Encontraste un error? ¡Abre un issue!
💡 ¿Tienes una idea? ¡Queremos escucharla!
🔧 ¿Quieres contribuir con código? ¡Envíanos un PR!
📚 ¿Mejorar la documentación? ¡Eres nuestro héroe!