Huuh MCP Server

🚀 Huuh MCP Server - IA colaborativa para todos! 🎓

O Huuh MCP Server é o seu servidor Model Context Protocol amigável que conecta aplicações de IA à plataforma huuh.me 🤖💝

Com o huuh.me você pode:

• 📚 Conhecimento nativo de IA
  • criar bases de conhecimento
  • recuperar e contribuir com conteúdo diretamente no chat
• 🫂 IA compartilhada para sua equipe
  • compartilhar e colaborar em bases de conhecimento com outras pessoas
  • permitir que elas recuperem e contribuam
• 🎭 melhores resultados com uso flexível
  • Crie e compartilhe personas de IA (system prompts)
  • alterne da sua IA de Pesquisa para a sua IA de Marketing direto no chat

✨ O Que Este Servidor Faz?

Nosso servidor é como um canivete suíço para a colaboração na era da IA! 🔧📚 Você pode:

• 🔍 Explorar Bases: Pesquise nas bases de conhecimento públicas do marketplace
• 📖 Acessar Informações: Recupere informações específicas de uma das suas bases ou de qualquer base pública
• 🎭 Gerenciar Personas: Obtenha e atualize personas de IA para aplicar rapidamente system prompts no chat
• 📝 Contribuir com Conteúdo: Adicione suas próprias contribuições às bases e ajude a construir a base de conhecimento
• 🛠️ Contribuir com Personas: Contribua com personas que você considera úteis para uma base pública
• 🏗️ Criar Bases: Inicie novas bases de conhecimento para seus projetos
• 🔗 Atribuir Bases a Espaços: Compartilhe bases com sua equipe ou workspace
• 🌟 Criar Espaços: Configure espaços colaborativos para trabalho em equipe

Para usar o servidor, registre-se na plataforma huuh.me e obtenha sua chave de API. Este servidor foi projetado para funcionar com a API da huuh, então você precisará de uma conta para começar! 🌐

🛠️ Ferramentas Disponíveis - Sua Caixa de Ferramentas de IA!

Nosso servidor vem com 10 ferramentas incríveis que facilitam o trabalho com conteúdo educacional:

1. 🏠 get_user_options

O que faz: Obtém informações sobre suas bases, módulos e arquivos disponíveis
Perfeito para: Começar sua jornada e entender o que está disponível para você!

2. 🛒 search_marketplace

O que faz: Pesquisa bases no marketplace
Parâmetros:

• query (string) - Seus termos de pesquisa (máximo 150 caracteres)
  Perfeito para: Descobrir novas bases e oportunidades educacionais!

3. 🔍 retrieve_information

O que faz: Recupera informações específicas do conteúdo das bases
Parâmetros:

• query (string) - O que você está procurando (máximo 150 caracteres)
• base_id (string) - Em qual base pesquisar
• relevant_blocks (array, opcional) - Módulos específicos para focar
• relevant_groups (array, opcional) - Grupos específicos para incluir
• relevant_file_ids (array, opcional) - Arquivos específicos para pesquisar
  Perfeito para: Obter respostas precisas dos materiais das bases!

4. 📝 contribute

O que faz: Adiciona suas próprias contribuições de conteúdo às bases
Parâmetros:

• base_id (string) - Base para contribuir
• folder_number (string) - Em qual pasta adicionar o conteúdo
• contribution_title (string) - Título da sua contribuição
• contribution_content (string) - Seu conteúdo incrível (máximo 30.000 caracteres)
  Perfeito para: Compartilhar conhecimento e ajudar outras pessoas a aprender!

5. 🎭 get_persona

O que faz: Recupera informações sobre personas de IA
Parâmetros:

• title (string) - Nome da persona que você deseja
  Perfeito para: Aplicar seus system prompts salvos no seu chat!

6. 🔄 refresh_persona

O que faz: Atualiza o conteúdo e o comportamento das personas
Parâmetros:

• title (string) - Persona a ser atualizada
• new_content (string) - Conteúdo atualizado da persona
• base_id (string, opcional) - Atualizações de persona específicas da base
  Perfeito para: Melhorar iterativamente system prompts para uso futuro!

7. 🎁 contribute_persona_to_base

O que faz: Adiciona uma nova persona a uma base (sua ou pública) Parâmetros:

• base_id (string) - Base para adicionar a persona
• persona_title (string) - Nome da sua nova persona
• persona_content (string) - Descrição e comportamento da persona (máximo 150 caracteres)
  Perfeito para: Armazenar system prompts para reaplicá-los no futuro!

8. 🏗️ create_base

O que faz: Cria uma nova base de conhecimento para seu conteúdo Parâmetros:

• base_name (string) - Nome da sua nova base
• base_description (string) - Descrição do que a base aborda
  Perfeito para: Iniciar novas bases de conhecimento para novos tópicos ou projetos!

9. 🔗 assign_base_to_space

O que faz: Atribui uma base existente a um espaço colaborativo Parâmetros:

• space_id (string) - ID do espaço para atribuir a base
• base_id (string) - ID da base a ser atribuída
  Perfeito para: Compartilhar bases com sua equipe ou workspace!

10. 🌟 create_spaces

O que faz: Cria um novo espaço colaborativo para trabalho em equipe Parâmetros:

• space_name (string) - Nome do seu novo espaço
• space_description (string) - Descrição do propósito do espaço
  Perfeito para: Configurar ambientes colaborativos para equipes e projetos!

🚀 Início Rápido - Configure em Segundos!

Instalando via Smithery

Para instalar o mcp para Claude Desktop automaticamente via Smithery:

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

Configuração do Claude Desktop

Adicione a seguinte configuração a claude-desktop.json:

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

🔧 Configuração de Desenvolvimento - Para os Entusiastas de Código!

Quer contribuir ou personalizar? Amamos desenvolvedores! 💻❤️

Pré-requisitos

• Python 3.12+ 🐍
• Gerenciador de pacotes uv ⚡

Passos de Configuração

# 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

Variáveis de Ambiente 📋

Crie um arquivo .env com:

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

# Optional: Set logging level
LOG_LEVEL=INFO

🔐 Autenticação - Segura e Simples!

O servidor usa autenticação por chave de API para manter seus dados seguros! 🛡️

1. 🔑 Obtenha sua chave de API na plataforma huuh.me
2. 🔒 Defina-a nas suas variáveis de ambiente
3. ✨ O servidor cuida do resto automaticamente!

📜 Licença - Liberdade para Aprender e Criar!

Este projeto está licenciado sob a Licença MIT 📄 - o que significa que você é livre para:

• ✅ Usá-lo comercialmente
• ✅ Modificá-lo como quiser
• ✅ Distribuí-lo para outras pessoas
• ✅ Usá-lo de forma privada
• ✅ Contribuir de volta para a comunidade

O único requisito? Manter o aviso de licença em trabalhos derivados. É isso! 🎉

🤝 Contribua - Junte-se à nossa Comunidade no Discord!

Adoraríamos a sua ajuda para tornar este servidor ainda mais incrível! 🌟

• 🐛 Encontrou um bug? Abra uma issue!
• 💡 Tem uma ideia? Queremos ouvir!
• 🔧 Quer contribuir com código? Envie um PR!
• 📚 Melhorar a documentação? Você é nosso herói!