Modelhub Port

io.github.CloudCorpRecords由 GitHub 账号 CloudCorpRecords 发布v0.1.0更新于 Nov 3, 2026

搜索并查看 Hugging Face 的模型、数据集、Spaces、论文和文档。

AI 翻译由 AI 模型根据下方的原文描述翻译，可能有误。

原文描述

Search and inspect Hugging Face models, datasets, spaces, papers and docs.

发布方自己的服务：Port

已验证STDIO仅桌面知识与记忆

服务详情

标识符: io.github.CloudCorpRecords/modelhub-port
传输: STDIO
运行时: Desktop only
信任: Verified
发布于: Nov 3, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此条目所属的 GitHub 账号 CloudCorpRecords。这并不表明该账号就是产品方。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.CloudCorpRecords%2Fmodelhub-port.svg)](https://sourceweft.com/mcp/io.github.CloudCorpRecords%2Fmodelhub-port?utm_source=readme&utm_medium=badge)

概览

Modelhub Port 的本地 MCP 服务；无需登录；STDIO。

暂无 AI 概览：以下信息来自注册中心条目和服务本身。

安装

在 SourceWeft 中

打开控制台中的 Modelhub Port，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照仓库中的启动说明。

README

modelhub-port

modelhub-port lets an agent explore the Hugging Face Hub without leaving its tools: look up who a token belongs to, inspect a model, dataset, or space in detail, search across all three repository kinds, list a repository's files, search the daily papers, and search or fetch pages from the Hugging Face documentation. It works from the command line or as an MCP server.

No token is needed to get started. The public Hub endpoints work anonymously, so every tool except hf_whoami runs keyless. When HF_TOKEN is set (the HUGGING_FACE_HUB_TOKEN alias is also accepted), requests carry it as a Bearer token, which raises rate limits and unlocks private or gated content the token can see. hf_whoami is the one tool that needs a token, because its whole job is to say whose token it is; without one it answers with an error naming HF_TOKEN.

Install

Or run the container image:

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

CLI

bash

# Whose token is configured? (requires HF_TOKEN)modelhub-port whoami
# Repository details and file listingsmodelhub-port details meta-llama/Llama-3.1-8Bmodelhub-port details squad --type datasetsmodelhub-port files meta-llama/Llama-3.1-8B
# Search models (default), datasets, or spacesmodelhub-port search "text generation" --sort downloads --limit 10modelhub-port search --type datasets --author google
# Papers and documentationmodelhub-port papers "retrieval augmented generation"modelhub-port doc-search "fine-tuning"modelhub-port doc-fetch https://huggingface.co/docs/transformers/index
modelhub-port --version

# Whose token is configured? (requires HF_TOKEN)modelhub-port whoami
# Repository details and file listingsmodelhub-port details meta-llama/Llama-3.1-8Bmodelhub-port details squad --type datasetsmodelhub-port files meta-llama/Llama-3.1-8B
# Search models (default), datasets, or spacesmodelhub-port search "text generation" --sort downloads --limit 10modelhub-port search --type datasets --author google
# Papers and documentationmodelhub-port papers "retrieval augmented generation"modelhub-port doc-search "fine-tuning"modelhub-port doc-fetch https://huggingface.co/docs/transformers/index
modelhub-port --version

Exit codes: 0 on success, 1 when a lookup fails (the error names the problem, including the HTTP status when the Hub answers with one), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

MCP client configuration:

json

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

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

The env block is optional — leave it out entirely to run keyless.

Tools

Tool	Input	What it returns
`hf_whoami`	(none)	The account the configured `HF_TOKEN` belongs to. Errors naming `HF_TOKEN` when no token is set.
`hub_repo_details`	`repo_id` (string, required), `repo_type` (string, optional), `revision` (string, optional)	Author, downloads, likes, dates, tags, and file names for one model, dataset, or space.
`hub_repo_search`	`search`, `repo_type`, `author`, `sort`, `limit`, `direction` (all optional)	A ranked list of matching repositories of the chosen kind.
`paper_search`	`query` (string, required), `limit` (number, optional)	Papers matching the query, with authors, dates, and summaries.
`hf_doc_search`	`query` (string, required), `limit` (number, optional)	Matching pages from the Hugging Face documentation.
`hf_doc_fetch`	`url` (string, required)	The text of one `huggingface.co/docs` page, with markup stripped.
`list_repo_files`	`repo_id` (string, required), `repo_type`, `revision`, `path` (optional)	The file tree of a repository at a revision, defaulting to `main`.

Hosted-only surfaces are out of scope for this rebuild: invoking Gradio spaces as tools, running jobs, managing buckets or collections, and upload/write operations are not included.

Development

bash

npm installnpm 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

npm installnpm 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