Hub Semantic Search MCP

🚀 Hugging Face Hub Semantic Search MCP Server

このサーバーは、Hugging Faceのモデルとデータセットに対して意味検索機能を提供するMCP（Model Context Protocol）サーバーです。Claudeや他のMCP互換クライアントが、自然言語クエリを使用してHugging Faceエコシステムを検索、発見、探索できるようになります。

⚠️ 重要な注意

これはHugging Faceの公式MCPサーバーにインスパイアされた非公式のMCPサーバーです。公式の機能に置き換えられた場合、いつでも廃止される可能性があります。公式サーバーについては、hf.co/mcpを参照してください。

✨ 主な機能

• 意味検索：AIによる類似性検索（単なるキーワードマッチングではない）
• データセット検索：自然言語の説明に基づいてデータセットを検索
• モデル検索：オプションでパラメータ数を指定してモデルを検索
• 類似性検索：指定されたモデル/データセットに類似するものを検索
• トレンドコンテンツ：現在トレンドのモデルとデータセットを取得
• 詳細メタデータ：HuggingFace APIを介して包括的な技術情報にアクセス
• モデル/データセットカード：詳細情報のためのREADMEカードをダウンロード

🛠️ 利用可能なツール

データセットツール

• search_datasets：自然言語クエリを使用してデータセットを検索
• find_similar_datasets：指定されたデータセットに類似するものを検索
• get_trending_datasets：現在トレンドのデータセットを取得
• get_dataset_info：特定のデータセットの詳細メタデータを取得
• download_dataset_card：データセットのREADMEカードをダウンロード

モデルツール

• search_models：パラメータフィルタリングを使用して自然言語クエリでモデルを検索
• find_similar_models：指定されたモデルに類似するものを検索
• get_trending_models：パラメータフィルタリングを使用して現在トレンドのモデルを取得
• get_model_info：特定のモデルの詳細メタデータを取得
• get_model_safetensors_metadata：safetensorsからモデルのアーキテクチャ詳細とパラメータ数を取得
• download_model_card：モデルのREADMEカードをダウンロード

📦 インストール

前提条件

• UV - 高速Pythonパッケージインストーラー
• Claude Desktopまたは他のMCP互換クライアント

クイックスタート

インストールは必要ありません！UVが自動的にサーバーを取得して実行します。

⚙️ 設定

Claude Desktopの設定

Claude Desktopの設定ファイルに以下を追加してください。

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "huggingface-hub-search": {
      "command": "uvx",
      "args": [
        "git+https://github.com/davanstrien/hub-semantic-search-mcp.git"
      ],
      "env": {
        "HF_SEARCH_API_URL": "https://davanstrien-huggingface-datasets-search-v2.hf.space"
      }
    }
  }
}

代替案：ローカル開発環境の設定

コードに貢献したり、変更したりする場合は、以下の手順を実行してください。

# リポジトリをクローン
git clone https://github.com/davanstrien/hub-semantic-search-mcp.git
cd hub-semantic-search-mcp

# UVで依存関係をインストール
uv sync

その後、Claude Desktopがローカルバージョンを使用するように設定します。

{
  "mcpServers": {
    "huggingface-hub-search": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/hub-semantic-search-mcp",
        "run",
        "python",
        "app.py"
      ],
      "env": {
        "HF_SEARCH_API_URL": "https://davanstrien-huggingface-datasets-search-v2.hf.space"
      }
    }
  }
}

💻 使用例

設定が完了したら、Claude Desktopで以下のようにツールを使用できます。

データセットの検索

"Find datasets about climate change and weather patterns"（気候変動と気象パターンに関するデータセットを検索）

モデルの検索

"Find small language models under 1B parameters for text generation"（テキスト生成用の10億パラメータ未満の小規模言語モデルを検索）

類似コンテンツの検索

"Find datasets similar to 'squad' for question answering"（質問応答用の'squad'に類似するデータセットを検索）

トレンドコンテンツの取得

"Show me the top 10 trending AI models this week"（今週のトップ10のトレンドAIモデルを表示）

詳細メタデータの取得

"Get detailed information about the 'stanford-nlp/imdb' dataset"（'stanford-nlp/imdb'データセットの詳細情報を取得） "Show me technical details and configuration for 'microsoft/DialoGPT-medium'"（'microsoft/DialoGPT-medium'の技術詳細と設定を表示） "What's the parameter count and architecture of 'microsoft/DialoGPT-medium'?"（'microsoft/DialoGPT-medium'のパラメータ数とアーキテクチャは何ですか？）

ドキュメントのダウンロード

"Download the model card for 'microsoft/DialoGPT-medium'"（'microsoft/DialoGPT-medium'のモデルカードをダウンロード）

🌐 環境変数

• HF_SEARCH_API_URL：検索APIのベースURL（デフォルト：https://davanstrien-huggingface-datasets-search-v2.hf.space）

🔍 検索バックエンド

このMCPサーバーは、AI生成の要約でHugging Faceのモデルとデータセットをインデックス化する意味検索APIに接続します。検索はキーワードマッチングではなく埋め込みベースの類似性を使用するため、意図と意味に基づいて関連するコンテンツを見つけるのにより効果的です。

🛠️ 開発

ローカルでの実行

# サーバーを直接実行
uv run python app.py

# または仮想環境をアクティブ化
uv shell
python app.py

MCP Inspectorでのテスト

# GitHubバージョンをテスト
npx @modelcontextprotocol/inspector uvx git+https://github.com/davanstrien/hub-semantic-search-mcp.git

# またはローカルでテスト
npx @modelcontextprotocol/inspector uv run python app.py

🤝 貢献

貢献は大歓迎です！問題やプルリクエストを自由に提出してください。

開発環境のセットアップ

git clone https://github.com/davanstrien/hub-semantic-search-mcp.git
cd hub-semantic-search-mcp
uv sync --dev

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

📚 関連プロジェクト

• Model Context Protocol
• Hugging Face Hub
• Claude Desktop
• UV - 高速Pythonパッケージインストーラー