PromptHub MCP 使用指南

把 PromptHub 接进 Claude Code / Codex，在编码会话里直接搜索、取用、整理、发布提示词——不用切到浏览器。

本仓库既是教程（看这篇 README），也是工具箱（左侧 6 个文件是开箱即用的 prompt，打开任意一个 → 切到「编辑模式」填变量 → 一键复制或直接带到对话里）。

0. 前置准备

1. 注册 / 登录 PromptHub（GitHub 或 Google OAuth）。
2. 到 设置 → 访问令牌 生成一个 PAT（形如 ph_xxx）。令牌只展示一次，妥善保存；它是敏感信息，不要提交到任何仓库。

1. 安装（唯一方式：GitHub 仓直装，不走 npm registry）

Claude Code：

# 推荐：装一次，启动快
npm i -g github:LionelHao/prompthub-mcp
claude mcp add prompthub --env PROMPTHUB_TOKEN=ph_xxx -- prompthub-mcp

# 或零安装
claude mcp add prompthub --env PROMPTHUB_TOKEN=ph_xxx -- npx -y github:LionelHao/prompthub-mcp

Codex（~/.codex/config.toml，先 npm i -g github:LionelHao/prompthub-mcp）：

[mcp_servers.prompthub]
command = "prompthub-mcp"
env = { PROMPTHUB_TOKEN = "ph_xxx" }

装好后在对话里说一句「调用 prompthub_whoami 验证」，返回你的 handle 即接通。嫌麻烦就直接用本仓库的 setup/connect，把整个接入过程交给 agent 做。

已经装过的，记得 npm i -g github:LionelHao/prompthub-mcp 更新到最新版，才能用到下面标 🆕 的能力。

2. 六个场景 prompt 怎么用

| 文件 | 场景 |

|---|---|

| setup/connect | 让 agent 替你完成安装、配置、验证全流程 |

| use/search-and-pull | 按主题搜索公开仓库，取回最合适的 prompt 并适配你的场景 |

| use/recommend-while-writing 🆕 | 写 prompt 前让 agent 按使用量推荐社区现成方案，点链接看完再决定用不用 |

| use/organize-and-publish | 把一段原始 prompt 按官方方法论整理成变量模板后发布 |

| use/publish-session | 把当前会话里打磨出的成果蒸馏成仓库一键发布 |

| use/update-repo | 拉取自己已有仓库，按修改意见更新后保存 |

每个 prompt 里的 {{变量}} 在网页上会渲染成表单：默认值已预填、可改可清空，填完右侧实时预览，复制的就是替换后的成品。

3. MCP 工具速查

| 工具 | 作用 |

|---|---|

| prompthub_whoami | 验证令牌，返回当前账号 |

| prompthub_search | 全文搜索公开仓库（结果带可点击的仓库链接） |

| prompthub_recommend 🆕 | 写 prompt 前按「热门分」（去重复制人数 + 收藏）推荐高使用量公开仓库，返回带站点链接的候选清单 |

| prompthub_list_repos / prompthub_get_repo | 列出 / 读取仓库（含文件、产物、参考素材，均带可点击链接） |

| prompthub_create_repo / prompthub_update_repo / prompthub_delete_repo | 建 / 改 / 删仓库 |

| prompthub_publish_session | 把当前编码会话蒸馏成仓库发布 |

| prompthub_organize_prompt | 获取「上传前整理提示词」官方方法论（清晰化 + 变量模板化） |

| prompthub_upload_artifact / prompthub_publish_artifact | 上传 / 发布运行产物（网页、文档、图片等） |

| prompthub_upload_reference | 上传 prompt 的输入参考素材 |

| prompthub_describe_file_format 等 | 不确定数据形状时先问它 |

🆕 标记的能力随 prompthub-mcp 最新版（0029）提供；老版本调不到 prompthub_recommend 时，先按 §1 更新一次即可。搜索 / 读取 / 推荐类工具均已返回可点击的完整仓库链接（url 字段）。

4. 更多

• MCP server 源码与完整文档：[github.com/LionelHao/prompthub-mcp](https://github.com/LionelHao/prompthub-mcp)
• 站内帮助页：/help
• 三种文件形态都支持发布：单文本（text）、对话（conversation）、工作流（workflow）

安全提示：发布会话内容前先脱敏——秘钥、内部域名、个人信息不要带上来。