https://github.com/infolab-ai/mcp
https://github.com/infolab-ai/mcp
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/infolab-ai/mcp
- Owner: infolab-ai
- Created: 2025-05-05T17:08:37.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-06-27T09:11:30.000Z (5 months ago)
- Last Synced: 2025-06-27T10:24:53.437Z (5 months ago)
- Language: Python
- Size: 153 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- toolsdk-mcp-registry - ❌ huuh - native Youtube (Other Tools and Integrations / How to Submit)
README
# 🚀 Huuh MCP Server - Collaborative AI for everybody! 🎓
[](https://smithery.ai/server/@infolab-ai/mcp)
The **Huuh MCP Server** is your friendly neighborhood Model Context Protocol server that bridges the gap between AI applications and the [huuh.me](https://huuh.me) platform 🤖💝
With [huuh.me](https://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 with in chat
## ✨ What Does This Server Do?
Our server is like a Swiss Army knife for collaboration in the era of AI! 🔧📚 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 team work
To use the server, please register on the [huuh.me](https://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 comes packed with **10 incredible tools** that make working with educational content a breeze:
### 1. 🏠 `get_user_options`
**What it does:** Gets information about your available bases, modules, and files
**Perfect for:** Starting your journey and understanding what's available to you!
### 2. 🛒 `search_marketplace`
**What it does:** Search for bases in the marketplace
**Parameters:**
- `query` (string) - Your search terms (max 150 characters)
**Perfect for:** Discovering new bases and educational opportunities!
### 3. 🔍 `retrieve_information`
**What it does:** 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_blocks` (array, optional) - Specific modules to focus on
- `relevant_groups` (array, optional) - Specific groups to include
- `relevant_file_ids` (array, optional) - Specific files to search
**Perfect for:** Getting precise answers from base materials!
### 4. 📝 `contribute`
**What it does:** Add your own content contributions to bases
**Parameters:**
- `base_id` (string) - Base 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)
**Perfect for:** Sharing knowledge and helping others learn!
### 5. 🎭 `get_persona`
**What it does:** Retrieve information about AI personas
**Parameters:**
- `title` (string) - Name of the persona you want
**Perfect for:** Applying your stored system prompts in your chat!
### 6. 🔄 `refresh_persona`
**What it does:** Update persona content and behavior
**Parameters:**
- `title` (string) - Persona to update
- `new_content` (string) - Updated persona content
- `base_id` (string, optional) - Base-specific persona updates
**Perfect for:** Iteratively improving system prompts for future use!
### 7. 🎁 `contribute_persona_to_base`
**What it does:** Add a brand new persona to a base (yours or public)
**Parameters:**
- `base_id` (string) - Base to add persona to
- `persona_title` (string) - Name of your new persona
- `persona_content` (string) - Persona description and behavior (max 150 characters)
**Perfect for:** Storing system prompts to reapply them in the future!
### 8. 🏗️ `create_base`
**What it does:** 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
**Perfect for:** Starting fresh knowledge bases for new topics or projects!
### 9. 🔗 `assign_base_to_space`
**What it does:** 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
**Perfect for:** Sharing bases with your team or workspace!
### 10. 🌟 `create_spaces`
**What it does:** Create a new collaborative space for team work
**Parameters:**
- `space_name` (string) - Name of your new space
- `space_description` (string) - Description of the space's purpose
**Perfect 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](https://smithery.ai/server/@infolab-ai/mcp):
```bash
npx -y @smithery/cli install @infolab-ai/mcp --client claude
```
### Claude Desktop Configuration
Add the following configuration to `claude-desktop.json`:
```json
{
"mcpServers": {
"huuh-mcp": {
"command": "uvx",
"args": ["huuh-mcp"],
"env": {
"HUUH_APIK_KEY": ""
}
}
}
}
```
## 🔧 Development Setup - For the Code Enthusiasts!
Want to contribute or customize? We love developers! 💻❤️
### Prerequisites
- Python 3.12+ 🐍
- [uv](https://docs.astral.sh/uv/) package manager ⚡
### Setup Steps
```bash
# 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:
```env
# 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 keep your data safe! 🛡️
1. 🔑 Get your API key from the [huuh.me](https://huuh.me) platform
2. 🔒 Set it in your environment variables
3. ✨ The server handles the rest automatically!
## 📜 License - Freedom to Learn and Build!
This project is licensed under the **MIT License** 📄 - which means you're free to:
- ✅ Use it commercially
- ✅ Modify it however you want
- ✅ Distribute it to others
- ✅ Use it privately
- ✅ Contribute back to the community
The only requirement? Keep the license notice in derivative works. That's it! 🎉
## 🤝 [Contributing - Join our Discord Community!](https://discord.gg/6YypQX2F)
We'd love your help making this server even more awesome! 🌟
- 🐛 Found a bug? Open an issue!
- 💡 Have an idea? We want to hear it!
- 🔧 Want to contribute code? Send us a PR!
- 📚 Improve documentation? You're our hero!