huuh - AI for teams and communities

🚀 Huuh MCP 服务 - 人人皆可参与的协作式 AI！🎓

Huuh MCP Server 是一个友好的 Model Context Protocol 服务，可在 AI 应用与 huuh.me 平台之间搭建桥梁 🤖💝

使用 huuh.me，你可以：

• 📚 AI 原生知识
  • 创建知识库
  • 直接在聊天中检索和贡献内容
• 🫂 团队共享 AI
  • 与他人共享知识库并协作
  • 让他们进行检索和贡献
• 🎭 灵活使用，获得更好的结果
  • 创建并分享 AI 人设（系统提示词）
  • 在聊天中将研究 AI 切换为营销 AI

✨ 这个服务能做什么？

我们的服务就像 AI 时代协作的瑞士军刀！🔧📚 你可以：

• 🔍 探索知识库：搜索市场中的公开知识库
• 📖 访问信息：从你的某个知识库或任意公开知识库中检索特定信息
• 🎭 管理人设：获取和更新 AI 人设，以便在聊天中快速应用系统提示词
• 📝 贡献内容：向知识库添加你自己的贡献，帮助构建知识库
• 🛠️ 贡献人设：将你认为有用的人设贡献到公开知识库
• 🏗️ 创建知识库：为你的项目创建新的知识库
• 🔗 将知识库分配到空间：与团队或工作区共享知识库
• 🌟 创建空间：设置用于团队协作的空间

要使用此服务，请在 huuh.me 平台注册并获取 API 密钥。此服务专为配合 huuh API 使用而设计，因此你需要先拥有一个账户！🌐

🛠️ 可用工具 - 你的 AI 工具箱！

我们的服务包含 10 个强大的工具，让处理教育内容变得轻松简单：

1. 🏠 get_user_options

功能： 获取有关你可用的知识库、模块和文件的信息
适用场景： 开始探索并了解你可以使用哪些内容！

2. 🛒 search_marketplace

功能： 在市场中搜索知识库
参数：

• query (string) - 你的搜索词（最多 150 个字符）
  适用场景： 探索新的知识库和教育机会！

3. 🔍 retrieve_information

功能： 从知识库内容中检索特定信息
参数：

• query (string) - 你要查找的内容（最多 150 个字符）
• base_id (string) - 要搜索的知识库
• relevant_blocks (array, optional) - 要重点查找的特定模块
• relevant_groups (array, optional) - 要纳入搜索的特定组
• relevant_file_ids (array, optional) - 要搜索的特定文件
  适用场景： 从知识库资料中获取准确答案！

4. 📝 contribute

功能： 向知识库添加你自己的贡献内容
参数：

• base_id (string) - 要贡献内容的知识库
• folder_number (string) - 要添加内容的文件夹
• contribution_title (string) - 你的贡献标题
• contribution_content (string) - 你的精彩内容（最多 30,000 个字符）
  适用场景： 分享知识并帮助他人学习！

5. 🎭 get_persona

功能： 检索有关 AI 人设的信息
参数：

• title (string) - 你想要的人设名称
  适用场景： 在聊天中应用你保存的系统提示词！

6. 🔄 refresh_persona

功能： 更新人设内容和行为
参数：

• title (string) - 要更新的人设
• new_content (string) - 更新后的人设内容
• base_id (string, optional) - 针对特定知识库的人设更新
  适用场景： 反复改进系统提示词，以便将来使用！

7. 🎁 contribute_persona_to_base

功能： 将全新的 Persona 添加到知识库（你自己的或公开的） 参数：

• base_id（string）- 要添加 Persona 的知识库
• persona_title（string）- 新 Persona 的名称
• persona_content（string）- Persona 的描述和行为（最多 150 个字符）
  适用场景： 保存系统提示词，以便日后重新使用！

8. 🏗️ create_base

功能： 为你的内容创建新的知识库 参数：

• base_name（string）- 新知识库的名称
• base_description（string）- 知识库内容的说明
  适用场景： 为新主题或项目创建全新的知识库！

9. 🔗 assign_base_to_space

功能： 将现有知识库分配给协作空间 参数：

• space_id（string）- 要分配知识库的空间 ID
• base_id（string）- 要分配的知识库 ID
  适用场景： 与团队或工作区共享知识库！

10. 🌟 create_spaces

功能： 创建新的团队协作空间 参数：

• space_name（string）- 新空间的名称
• space_description（string）- 空间用途说明
  适用场景： 为团队和项目搭建协作环境！

🚀 快速开始 — 几秒钟即可运行！

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 MCP：

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

Claude Desktop 配置

将以下配置添加到 claude-desktop.json：

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

🔧 开发环境设置 — 献给热爱代码的你！

想要参与贡献或自定义？我们欢迎开发者！💻❤️

前置条件

• Python 3.12+ 🐍
• uv 包管理器 ⚡

设置步骤

# 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

环境变量 📋

创建一个 .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

🔐 身份验证 — 安全又简单！

此服务使用 API 密钥进行身份验证，保障你的数据安全！🛡️

1. 🔑 从 huuh.me 平台获取 API 密钥
2. 🔒 在环境变量中设置该密钥
3. ✨ 服务会自动处理其余事项！

📜 许可证 — 自由学习与构建！

本项目采用 MIT License 📄 许可，这意味着你可以自由：

• ✅ 将其用于商业用途
• ✅ 随心修改
• ✅ 分发给他人
• ✅ 私下使用
• ✅ 为社区贡献代码

唯一要求？在衍生作品中保留许可证声明。就这么简单！🎉

🤝 参与贡献 — 加入我们的 Discord 社区！

欢迎你帮助我们让这个服务变得更出色！🌟

• 🐛 发现 Bug？提交 issue！
• 💡 有想法？告诉我们！
• 🔧 想贡献代码？向我们提交 PR！
• 📚 想改进文档？你就是我们的英雄！