huuh - AI for teams and communities

🚀 Huuh MCP Server - みんなのための協働型 AI！ 🎓

Huuh MCP Server は、AI アプリケーションと huuh.me プラットフォームをつなぐ、身近な Model Context Protocol サーバーです 🤖💝

huuh.me では、次のことができます。

• 📚 AI ネイティブなナレッジ
  • ナレッジベースを作成する
  • チャット内でコンテンツを直接取得、投稿する
• 🫂 チームで共有する AI
  • 他のメンバーとナレッジベースを共有し、共同作業する
  • 他のメンバーがナレッジを取得、投稿できるようにする
• 🎭 柔軟な使い方でより良い成果を
  • AI ペルソナ（システムプロンプト）を作成、共有する
  • チャット内で、Research AI から Marketing 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、任意）- 対象にする特定のモジュール
• relevant_groups（array、任意）- 含める特定のグループ
• relevant_file_ids（array、任意）- 検索する特定のファイル
  最適な用途： ベースの資料から正確な回答を得るのに最適です！

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、任意）- ベース固有のペルソナ更新
  最適な用途： 今後利用するシステムプロンプトを反復的に改善するのに最適です！

7. 🎁 contribute_persona_to_base

機能: 新しいペルソナをベース（自分のもの、または公開されているもの）に追加します パラメーター:

• base_id (string) - ペルソナを追加するベース
• persona_title (string) - 新しいペルソナの名前
• persona_content (string) - ペルソナの説明と振る舞い（最大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 経由で mcp を Claude Desktop に自動インストールするには：

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 コミュニティに参加しましょう！

このサーバーをさらに素晴らしいものにするため、ぜひご協力ください！🌟

• 🐛 バグを見つけましたか？イシューを作成しましょう！
• 💡 アイデアがありますか？ぜひお聞かせください！
• 🔧 コードで貢献したいですか？PR をお送りください！
• 📚 ドキュメントを改善しますか？あなたは私たちのヒーローです！