modelhub-port

modelhub-port

modelhub-port を使うと、エージェントは使用中のツールを離れることなく Hugging Face Hub を探索できます。トークンの所有者を調べたり、モデル、データセット、スペースの詳細を確認したり、3 種類すべてのリポジトリを検索したり、リポジトリのファイル一覧を取得したり、日次論文を検索したり、Hugging Face のドキュメントを検索または取得したりできます。コマンドラインからも MCP サーバーとしても利用できます。

始めるのにトークンは必要ありません。公開 Hub エンドポイントは匿名で利用できるため、hf_whoami を除くすべてのツールはキーなしで動作します。HF_TOKEN が設定されている場合（HUGGING_FACE_HUB_TOKEN というエイリアスも使用できます）、リクエストに Bearer トークンが付与され、レート制限が緩和され、トークンからアクセスできる非公開またはゲート付きコンテンツを利用できるようになります。hf_whoami は、トークンの所有者を返すことが目的のため、トークンが必要な唯一のツールです。トークンがない場合は、HF_TOKEN を指定するエラーを返します。

インストール

npx @reneturcios/modelhub-port search llama --limit 5

または、コンテナーイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/modelhub-port

コンテナーはデフォルトで MCP サーバーとして起動します（下記を参照）。CLI として使うには、CLI 引数を渡します。

CLI

# Whose token is configured? (requires HF_TOKEN)
modelhub-port whoami

# Repository details and file listings
modelhub-port details meta-llama/Llama-3.1-8B
modelhub-port details squad --type datasets
modelhub-port files meta-llama/Llama-3.1-8B

# Search models (default), datasets, or spaces
modelhub-port search "text generation" --sort downloads --limit 10
modelhub-port search --type datasets --author google

# Papers and documentation
modelhub-port papers "retrieval augmented generation"
modelhub-port doc-search "fine-tuning"
modelhub-port doc-fetch https://huggingface.co/docs/transformers/index

modelhub-port --version

終了コード：成功時は 0、検索に失敗した場合は 1（エラーには問題の内容と、Hub から応答があった場合は HTTP ステータスが示されます）、使用方法に誤りがある場合は 2 です。

MCP サーバー

1 つのバイナリで両方の用途に対応します。mcp サブコマンドを実行すると、stdio MCP サーバーが起動します。

npx -y @reneturcios/modelhub-port mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "modelhub-port": {
      "command": "npx",
      "args": ["-y", "@reneturcios/modelhub-port", "mcp"],
      "env": {
        "HF_TOKEN": "your-token-if-you-have-one"
      }
    }
  }
}

env ブロックは省略可能です。キーなしで実行する場合は、ブロック全体を省略してください。

ツール

ツール	入力	返される内容
hf_whoami	(なし)	設定済みの HF_TOKEN が属するアカウントです。トークンが設定されていない場合は、HF_TOKEN を指定するエラーを返します。
hub_repo_details	repo_id（文字列、必須）、repo_type（文字列、省略可能）、revision（文字列、省略可能）	1 つのモデル、データセット、またはスペースの作成者、ダウンロード数、いいね数、日付、タグ、ファイル名です。
hub_repo_search	search、repo_type、author、sort、limit、direction（すべて省略可能）	選択した種類に一致するリポジトリのランキング一覧です。
paper_search	query（文字列、必須）、limit（数値、省略可能）	クエリに一致する論文と、その著者、日付、概要です。
hf_doc_search	query（文字列、必須）、limit（数値、省略可能）	Hugging Face ドキュメント内で一致するページです。
hf_doc_fetch	url（文字列、必須）	マークアップを除去した、1 つの huggingface.co/docs ページのテキストです。
list_repo_files	repo_id（文字列、必須）、repo_type、revision、path（省略可能）	リビジョン時点のリポジトリのファイルツリーです。デフォルトは main です。

この再構築では、ホスト型の機能は対象外です。Gradio スペースのツールとしての呼び出し、ジョブの実行、バケットやコレクションの管理、アップロードや書き込み操作は含まれません。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。