MCP

🚀 Huuh MCP 服务器 - 人人可用的协作式人工智能！🎓

Huuh MCP 服务器是一款友好的模型上下文协议（Model Context Protocol）服务器，它架起了人工智能应用与 huuh.me 平台之间的桥梁 🤖💝。

借助 huuh.me，你可以：

• 📚 原生人工智能知识
  • 创建知识库
  • 直接在聊天中检索和贡献内容
• 🫂 团队共享人工智能
  • 与他人共享和协作处理知识库
  • 让他们进行检索和贡献
• 🎭 灵活使用，获得更好的结果
  • 构建并共享人工智能角色（系统提示）
  • 在聊天中从研究型人工智能切换到营销型人工智能

✨ 此服务器的功能

我们的服务器就像是人工智能时代协作的瑞士军刀！🔧📚你可以：

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

要使用该服务器，请在 huuh.me 平台上注册并获取你的 API 密钥。此服务器是为与 huuh API 配合使用而设计的，因此你需要一个账户才能开始使用！🌐

🛠️ 可用工具 - 你的人工智能工具箱！

我们的服务器配备了 10 个令人惊叹的工具，让处理教育内容变得轻而易举：

1. 🏠 get_user_options

功能：获取有关你可用的知识库、模块和文件的信息
适用场景：开启你的旅程，了解可供你使用的资源！

2. 🛒 search_marketplace

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

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

3. 🔍 retrieve_information

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

• query（字符串） - 你要查找的内容（最多 150 个字符）
• base_id（字符串） - 要搜索的知识库
• relevant_modules（数组，可选） - 要关注的特定模块
• relevant_groups（数组，可选） - 要包含的特定组
• relevant_file_ids（数组，可选） - 要搜索的特定文件
  适用场景：从知识库材料中获取精确答案！

4. 📝 contribute

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

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

5. 🎭 get_persona

功能：检索有关人工智能角色的信息
参数：

• title（字符串） - 你想要的角色名称
  适用场景：在聊天中应用你存储的系统提示！

6. 🔄 refresh_persona

功能：更新角色内容和行为
参数：

• title（字符串） - 要更新的角色
• new_content（字符串） - 更新后的角色内容
• base_id（字符串，可选） - 特定课程的角色更新
  适用场景：迭代改进系统提示，以备将来使用！

7. 🎁 contribute_persona_to_course

功能：向课程（你的或公共的）添加全新的角色 参数：

• course_id（字符串） - 要添加角色的课程
• persona_title（字符串） - 你的新角色名称
• persona_content（字符串） - 角色描述和行为（最多 150 个字符）
  适用场景：存储系统提示，以便将来重新应用！

8. 🏗️ create_base

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

• base_name（字符串） - 你的新知识库名称
• base_description（字符串） - 知识库的描述
  适用场景：为新主题或项目启动全新的知识库！

9. 🔗 assign_base_to_space

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

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

10. 🌟 create_spaces

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

• space_name（字符串） - 你的新空间名称
• space_description（字符串） - 空间用途的描述
  适用场景：为团队和项目设置协作环境！

🚀 快速开始 - 秒级启动并运行！

通过 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 包管理器 ⚡

设置步骤

# 克隆仓库
git clone https://github.com/infolab-ai/mcp.git
cd mcp

# 使用 uv 安装依赖项（它快如闪电！）
uv sync

# 激活虚拟环境
source .venv/bin/activate  # 在 Windows 上：.venv\Scripts\activate

# 设置环境变量
cp .env.sample .env
# 使用你的 API 凭证编辑 .env

# 在开发模式下运行服务器
uv --directory path/to/huuh_mcp -m huuh_mcp.server --env-file /path/to/.env

环境变量 📋

创建一个 .env 文件，内容如下：

# 你的 HUUH API 密钥（从你的账户设置中获取）
HUUH_APIK_KEY=your_api_key_here

# 可选：设置日志级别
LOG_LEVEL=INFO

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

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

1. 🔑 从 huuh.me 平台获取你的 API 密钥
2. 🔒 将其设置在你的环境变量中
3. ✨ 服务器会自动处理其余部分！

📜 许可证 - 自由学习和构建！

本项目采用 MIT 许可证 📄 - 这意味着你可以自由地：

• ✅ 商业使用
• ✅ 随意修改
• ✅ 分发给他人
• ✅ 私下使用
• ✅ 回馈社区

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

🤝 贡献代码 - 加入我们的 Discord 社区！

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

• 🐛 发现了漏洞？请提交一个问题！
• 💡 有想法？我们想听！
• 🔧 想贡献代码？请发送一个拉取请求！
• 📚 改进文档？你就是我们的英雄！