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 社區！

我們非常歡迎你幫助我們讓這個服務器變得更加出色！🌟

• 🐛 發現了漏洞？請提交一個問題！
• 💡 有想法？我們想聽！
• 🔧 想貢獻代碼？請發送一個拉取請求！
• 📚 改進文檔？你就是我們的英雄！