convez.ai
MCP ServerProdutividadeIntermediário
LionelHao

PromptHub MCP

LionelHao/prompthub-mcp

Publique e recupere prompts do PromptHub sem sair do Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-mcp

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
1

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

ToolWhat it does
prompthub_whoamiVerify the token; show your handle/name
prompthub_searchSearch public repos by keyword (model-aware — see below)
prompthub_recommendRecommend high-usage repos for a task (model-aware)
prompthub_get_repoFetch one repo (owner/name) with its file tree
prompthub_list_reposList your repos, or a user's public repos
prompthub_create_repoCreate a repo from explicit fields
prompthub_update_repoFull-replace one of your repos
prompthub_publish_sessionDistill the current session into a reusable repo and publish
prompthub_describe_file_formatShow 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-call model arg > PROMPTHUB_MODEL env > host. Unknown / multi-model hosts (e.g. Cursor) fall back to PROMPTHUB_MODEL.
  • Search & recommend — prompthub_search / prompthub_recommend rank prompts tagged for your model first — a preference, not a filter (model-agnostic prompts still appear). Results carry an appliedModel field + a short note to relay to the user.
  • Publishing — prompthub_create_repo / prompthub_publish_session / prompthub_update_repo auto-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 set PROMPTHUB_MODEL. Run prompthub_whoami to 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

Ver o original no GitHub

Bom para

Relacionados