MCP

🚀 Huuh MCP Server - Collaborative AI for everybody! 🎓

The Huuh MCP Server is a user - friendly Model Context Protocol server that connects AI applications with the huuh.me platform 🤖💝

With huuh.me, you can:

• 📚 AI - native knowledge
  • Create knowledge bases
  • Retrieve and contribute content directly in chat
• 🫂 Shared AI for your team
  • Share and collaborate on knowledge bases with others
  • Let them retrieve and contribute
• 🎭 Better results with flexible usage
  • Build and share AI personas (system prompts)
  • Switch from your Research AI to your Marketing AI within the chat

✨ Features

Our server is like a Swiss Army knife for collaboration in the AI era! 🔧📚 You can:

• 🔍 Explore Bases: Search through marketplace public knowledge bases
• 📖 Access Information: Retrieve specific information from one of your bases or any public base
• 🎭 Manage Personas: Get and update AI personas to quickly apply system prompts in the chat
• 📝 Contribute Content: Add your own contributions to bases and help build the knowledge base
• 🛠️ Contribute Personas: Contribute personas you find useful to a public base
• 🏗️ Create Bases: Start new knowledge bases for your projects
• 🔗 Assign Bases to Spaces: Share bases with your team or workspace
• 🌟 Create Spaces: Set up collaborative spaces for teamwork

To use the server, please register on the huuh.me platform and get your API key. This server is designed to work with the huuh API, so you'll need an account to get started! 🌐

🛠️ Available Tools - Your AI Toolbox!

Our server is equipped with 10 amazing tools that simplify working with educational content:

1. 🏠 get_user_options

Function: Gets information about your available bases, modules, and files
Ideal for: Starting your journey and understanding what's available to you!

2. 🛒 search_marketplace

Function: Search for bases in the marketplace
Parameters:

• query (string) - Your search terms (max 150 characters)
  Ideal for: Discovering new bases and educational opportunities!

3. 🔍 retrieve_information

Function: Retrieve specific information from base content
Parameters:

• query (string) - What you're looking for (max 150 characters)
• base_id (string) - Which base to search in
• relevant_modules (array, optional) - Specific modules to focus on
• relevant_groups (array, optional) - Specific groups to include
• relevant_file_ids (array, optional) - Specific files to search
  Ideal for: Getting precise answers from base materials!

4. 📝 contribute

Function: Add your own content contributions to bases
Parameters:

• base_id (string) - Course to contribute to
• folder_number (string) - Which folder to add content to
• contribution_title (string) - Title of your contribution
• contribution_content (string) - Your amazing content (max 30,000 characters)
  Ideal for: Sharing knowledge and helping others learn!

5. 🎭 get_persona

Function: Retrieve information about AI personas
Parameters:

• title (string) - Name of the persona you want
  Ideal for: Applying your stored system prompts in your chat!

6. 🔄 refresh_persona

Function: Update persona content and behavior
Parameters:

• title (string) - Persona to update
• new_content (string) - Updated persona content
• base_id (string, optional) - Course - specific persona updates
  Ideal for: Iteratively improving system prompts for future use!

7. 🎁 contribute_persona_to_course

Function: Add a brand new persona to a course (yours or public) Parameters:

• course_id (string) - Course to add persona to
• persona_title (string) - Name of your new persona
• persona_content (string) - Persona description and behavior (max 150 characters)
  Ideal for: Storing system prompts to reapply them in the future!

8. 🏗️ create_base

Function: Create a new knowledge base for your content Parameters:

• base_name (string) - Name of your new base
• base_description (string) - Description of what the base is about
  Ideal for: Starting fresh knowledge bases for new topics or projects!

9. 🔗 assign_base_to_space

Function: Assign an existing base to a collaborative space Parameters:

• space_id (string) - ID of the space to assign the base to
• base_id (string) - ID of the base to assign
  Ideal for: Sharing bases with your team or workspace!

10. 🌟 create_spaces

Function: Create a new collaborative space for teamwork Parameters:

• space_name (string) - Name of your new space
• space_description (string) - Description of the space's purpose
  Ideal for: Setting up collaborative environments for teams and projects!

🚀 Quick Start - Get Up and Running in Seconds!

Installing via Smithery

To install mcp for Claude Desktop automatically via Smithery:

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

Claude Desktop Configuration

Add the following configuration to claude-desktop.json:

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

📦 Installation

Prerequisites

• Python 3.12+ 🐍
• uv package manager ⚡

Setup Steps

# 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

Environment Variables 📋

Create a .env file with:

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

# Optional: Set logging level
LOG_LEVEL=INFO

🔐 Authentication - Secure and Simple!

The server uses API key authentication to protect your data! 🛡️

1. 🔑 Get your API key from the huuh.me platform
2. 🔒 Set it in your environment variables
3. ✨ The server takes care of the rest automatically!

📄 License

This project is licensed under the MIT License 📄, which allows you to:

• ✅ Use it commercially
• ✅ Modify it as you wish
• ✅ Distribute it to others
• ✅ Use it privately
• ✅ Contribute back to the community

The only requirement is to keep the license notice in derivative works. That's it! 🎉

🤝 Contributing - Join our Discord Community!

We welcome your help to make this server even better! 🌟

• 🐛 Found a bug? Open an issue!
• 💡 Have an idea? Share it with us!
• 🔧 Want to contribute code? Send us a PR!
• 📚 Want to improve documentation? You're our hero!