PromptHub MCP
LionelHao/prompthub-mcp
Publique e recupere prompts do PromptHub sem sair do Claude
Ver no GitHubServidor MCP que conecta Claude Code e Codex ao PromptHub, permitindo publicar, buscar, listar e atualizar repositórios de prompts diretamente da interface. Inclui detecção automática de modelo e recomendações personalizadas.
Instalação
npx convez-ai LionelHao/prompthub-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Compartilhar prompts reutilizáveis entre projetos
- Descobrir prompts otimizados para seu modelo específico
- Manter biblioteca centralizada de templates de prompts
- Publicar workflows e conversas como repositórios
Veredito

Ferramenta prática para quem trabalha com prompts em escala, com boa integração nativa no Claude Code. A detecção automática de modelo e busca ciente do contexto agregam valor real, mas requer conta no PromptHub e configuração inicial de token.
README
A tradução para o português deste README ainda está na fila.
prompthub-mcp
MCP server for PromptHub. Publish, fetch, list, update and search prompt repositories from Claude Code or Codex.
1. Get a token
Sign in at https://www.awesome-prompt.com → Settings → API tokens → create a token. Copy the ph_… value (shown once).
2. Configure
Either set an environment variable:
export PROMPTHUB_TOKEN=ph_xxx
# optional, defaults to https://www.awesome-prompt.com
export PROMPTHUB_BASE_URL=https://www.awesome-prompt.com
# optional — force which model search/recommend/publishing prefer (a registry slug,
# e.g. claude-sonnet-4-6). Overrides host auto-detection; handy for multi-model hosts.
export PROMPTHUB_MODEL=claude-sonnet-4-6
…or create ~/.prompthub/config.json:
{ "token": "ph_xxx", "baseUrl": "https://www.awesome-prompt.com", "model": "claude-sonnet-4-6" }
Environment variables take precedence over the file.
3. Register the server
The server installs straight from this public GitHub repo — no npm registry, no token to pull it.
Recommended — install once, then point at the prompthub-mcp binary (fast startup; builds on install):
npm i -g github:LionelHao/prompthub-mcp
claude mcp add prompthub --env PROMPTHUB_TOKEN=ph_xxx -- prompthub-mcp
Zero-install alternative — let npx fetch + build the repo on demand (slower cold start, always tracks main):
claude mcp add prompthub --env PROMPTHUB_TOKEN=ph_xxx -- npx -y github:LionelHao/prompthub-mcp
Codex — add to ~/.codex/config.toml. After npm i -g github:LionelHao/prompthub-mcp:
[mcp_servers.prompthub]
command = "prompthub-mcp"
env = { PROMPTHUB_TOKEN = "ph_xxx" }
Or zero-install (npx fetches + builds on demand):
[mcp_servers.prompthub]
command = "npx"
args = ["-y", "github:LionelHao/prompthub-mcp"]
env = { PROMPTHUB_TOKEN = "ph_xxx" }
4. Tools
| Tool | What it does |
|---|---|
prompthub_whoami | Verify the token; show your handle/name |
prompthub_search | Search public repos by keyword (model-aware — see below) |
prompthub_recommend | Recommend high-usage repos for a task (model-aware) |
prompthub_get_repo | Fetch one repo (owner/name) with its file tree |
prompthub_list_repos | List your repos, or a user's public repos |
prompthub_create_repo | Create a repo from explicit fields |
prompthub_update_repo | Full-replace one of your repos |
prompthub_publish_session | Distill the current session into a reusable repo and publish |
prompthub_describe_file_format | Show the exact files[] JSON shapes (text/conversation/workflow) |
Model-aware search & publishing
The server detects which AI model you're working with and tailors results to it — no setup needed:
- Detection — inferred from the MCP host (
clientInfo): Claude Code →claude-sonnet-4-6, Codex →gpt-5-5. Priority: per-callmodelarg >PROMPTHUB_MODELenv > host. Unknown / multi-model hosts (e.g. Cursor) fall back toPROMPTHUB_MODEL. - Search & recommend —
prompthub_search/prompthub_recommendrank prompts tagged for your model first — a preference, not a filter (model-agnostic prompts still appear). Results carry anappliedModelfield + a short note to relay to the user. - Publishing —
prompthub_create_repo/prompthub_publish_session/prompthub_update_repoauto-tag your prompt's text nodes with the current model (only nodes without an explicit model; image/video nodes are left untouched). The reply notes how many nodes were tagged. - Override anytime — tell the assistant "find Gemini prompts" (per-call
model), or setPROMPTHUB_MODEL. Runprompthub_whoamito see the detected host + resolved model.
Model slugs/labels come from the live registry at GET /api/v1/models.
5. First run
Confirm it's wired up — ask your assistant:
"Use prompthub_whoami to check my PromptHub login."
You should see your handle. Then publish:
"Publish the prompt we just wrote to PromptHub as a private repo called
my-first-prompt."
The assistant will call prompthub_publish_session and reply with the new repo URL (e.g. https://www.awesome-prompt.com/@you/my-first-prompt). If it's unsure of the format, it can call prompthub_describe_file_format first.
Organize a prompt before publishing
prompthub_organize_prompt(无参,无需令牌)取回「整理提示词」方法论:把原始 prompt 重写得更清晰,
并按 PromptHub 的 {{变量}} 规范模板化,便于他人编辑替换。发布前先调它,再用 create_repo /
publish_session 发布。
作为 Claude Code plugin 安装
本仓同时是 Claude Code plugin(声明了 MCP server + 原生 prompt-organize skill):
claude --plugin-dir /path/to/prompthub-mcp # 本地
# 或 /plugin install <git-url>
更新方法论文本后,重新生成 SKILL.md:
PROMPTHUB_BASE_URL=https://www.awesome-prompt.com npm run sync-skill
License
MIT