promptlike-mcp

promptlike — Claude Code 插件

在 Claude Code 中访问你的 PromptLikeEngineer 提示词库。你的提示词会保留在保存时所在的位置并纳入版本管理；Claude 会在需要时按名称提取提示词，无需复制粘贴，也不会在系统提示词中留下过时的副本。

安装

通过此仓库自带的市场安装——目前即可使用：

claude plugin marketplace add zeynepaslierhann/promptlike-plugin
claude plugin install promptlike@promptlikeengineer

在 Claude Code 会话中，同样的两个步骤是 /plugin marketplace add zeynepaslierhann/promptlike-plugin 和 /plugin install promptlike@promptlikeengineer。

通过社区市场安装（此插件上架后即可使用）：

/plugin marketplace add anthropics/claude-plugins-community

然后从 @claude-community 安装 promptlike。

也可以直接从此仓库的克隆版本安装，方便在不添加市场的情况下试用：

git clone https://github.com/zeynepaslierhann/promptlike-plugin
claude --plugin-dir ./promptlike-plugin

登录一次，让服务可以读取你的提示词库（它会共用 CLI 会话）：

npm i -g promptlike && ple login

即使不登录，插件仍会加载，工具也会列出——但每次调用都会返回“未登录。请先在终端运行 ple login（安装命令：npm i -g promptlike）。”，而不是返回提示词。此时，建议钩子会改用你的本地提示词（ple save）。

新增内容

组件	说明
promptlike MCP 服务	工具：list_prompts、search_prompts、get_prompt、fill_variables、suggest_prompts（读取）· save_prompt、update_prompt（写入——仅添加）
将你的提示词作为斜杠命令使用	每个已保存的提示词都是一个 MCP 提示词：输入 / 并选择，或运行 /mcp__plugin_promptlike_promptlike__<prompt-name>（例如，标题为“代码审查”的提示词会变为 code-review）。其中的 {{variables}} 会成为参数。/mcp__plugin_promptlike_promptlike__save-this 会保存当前对话中的可复用提示词
将你的提示词作为 @ 资源使用	promptlike://<repo>/<prompt> — 使用 @ 附加已保存的提示词
建议钩子	每条消息发送前，都会在本地与你已保存的提示词进行匹配；匹配到合适的提示词时，Claude 会收到一条简短说明（见下文）
/promptlike:prompt-library 技能	引导 Claude 优先使用已保存的提示词，而不是从头编写，并将优质提示词保存下来

插件通过 npx -y [email protected] 启动服务，并固定使用此确切版本。

示例

每个示例都从你要做的事开始。请替换为你自己提示词库中的提示词名称。

1. 按名称请求提示词。 你输入：

Run my code-review prompt on the changes in this branch.

Claude 会查找该提示词（如果名称不完全匹配，会先调用 search_prompts，然后调用 get_prompt），使用 fill_variables 填入其中的 {{variables}}，并按提示词内容执行。如果名称匹配多个提示词，Claude 会展示候选项，而不是自行猜测。

2. 从 / 菜单运行提示词。 你输入：

/mcp__plugin_promptlike_promptlike__code-review src/auth.ts security

命令后的内容会按提示词中变量首次出现的顺序填入 {{variables}}（例如，提示词先提到 {{file}}，再提到 {{focus}}，上面的两个词就会依次填入）。未提供的变量会以 {{name}} 的形式保留在 Claude 收到的文本中。

3. 保存刚刚整理出的内容。 你输入：

/mcp__plugin_promptlike_promptlike__save-this

该提示词会指示 Claude 从对话中提取可复用的指令，将每次使用时会变化的内容标记为 {{variables}}，向你展示标题、描述和文本，然后调用 save_prompt。保存操作仅支持添加；看起来像 API 密钥或令牌的文本会被拒绝。

在 Claude Code 中保存

请 Claude 保存提示词，或运行 /mcp__plugin_promptlike_promptlike__save-this。写入操作仅支持添加：save_prompt 会创建提示词，update_prompt 会添加新版本并保留旧版本。内容永远不会被删除，重复保存相同内容也不会产生变化。计划限额与网页版完全相同——达到限额时，Claude 会告知你，且不会保存任何内容。看起来像 API 密钥或令牌的内容会被拒绝。

建议钩子——功能及关闭方法

每次你发送消息时，Claude Code 都会运行 scripts/suggest.sh，该脚本会运行 ple suggest --hook（一个 UserPromptSubmit 钩子）。它会：

• 将你的消息与本机保存的提示词进行匹配——即你的提示词库的本地副本（或在退出登录时使用 ~/.promptlike）。你的消息不会发送到任何地方；
• 对斜杠命令、简短消息（少于 20 个字符）、匹配度较低的内容，以及本次会话中已经推荐过的提示词保持静默；
• 否则，会为 Claude 添加一条简短提示，列出最多三个提示词。只有在提示词明显相关时，Claude 才会获取它；
• 需要 CLI（npm i -g promptlike）；没有 CLI 时，钩子不会执行任何操作。它绝不会阻止你的消息：会在不到一秒内回复，或者保持静默。

可通过以下任一方式关闭：

• /config → PromptLikeEngineer → 建议已保存的提示词 → false（或运行 /plugin configure promptlike@promptlikeengineer）
• ple config set suggest off
• 在环境变量中设置 PLE_SUGGEST=off（或在 Claude Code 的 settings.json → env 中设置）

建议的显示次数仅在本机统计（可通过 ple stats 查看）；只有当 Claude 实际获取了推荐的提示词时，服务端才会得知。

数据与隐私

以下说明了此插件运行的所有内容，以及它会连接到的所有位置。

建议钩子。 每条消息发送前，Claude Code 都会运行 scripts/suggest.sh；如果安装了 ple CLI，它会运行 ple suggest --hook（否则不会发生任何事）。匹配过程在你的设备上进行。此钩子不会将你的消息发送到任何地方，也不会自行发起网络请求，更不会等待网络请求。后台会发生一件事：如果你已登录，且本地库副本缺失或超过 10 分钟未更新，此钩子会启动一个分离运行的 ple suggest --refresh-cache（每分钟最多一次），并通过你的 ple login 会话，从 promptlikeengineer.com 下载你自己的提示词列表，以便下一次匹配使用最新副本。上面提到的三个关闭开关都会停止此钩子及其刷新操作。匹配到合适的提示词时，Claude 会收到一条两行说明，其中列出最多三个提示词标题；和对话中的任何文本一样，这条说明会随该轮对话一起发送给模型。

你设备上的文件。 CLI 会将以下文件保存在 ~/.config/promptlike/（或 PROMPTLIKE_CONFIG_DIR 指定的文件夹）中；系统支持时，会以仅所有者可访问的权限创建：config.json（你的会话信息：令牌、电子邮件和用户 ID，由 ple login 写入）、settings.json（开关）、cache/library.json（最多 500 条提示词：标题、描述、标签、存储库、使用次数和正文的前 600 个字符），以及 cache/suggest-state.json（一个计数器，以及最近 20 个 Claude Code 会话中建议过的提示词）。退出登录后，此钩子会改为读取 ~/.promptlike。

MCP 服务。 Claude Code 会通过 npx -y [email protected] 启动它；首次启动时，npm 会从 npm registry 下载该确切版本。它在你的设备上运行，且只连接 https://promptlikeengineer.com（如果你设置了 PROMPTLIKE_API_URL，则连接该地址），使用 ple login 保存的会话进行身份验证，并在会话过期时通过同一主机刷新。它不包含其他网络代码。它发送的内容如下：

• 读取操作（list_prompts、search_prompts、get_prompt、fill_variables）会向你的账户请求你的提示词；Claude Code 还会请求用于填充 / 菜单和 @ 建议的列表（最多 500 条提示词，缓存 30 秒）；
• 当 Claude 获取提示词时——通过工具、/ 菜单或作为 @ 资源——服务端会记录一次使用事件：提示词及其版本、通过上述三种方式中的哪种方式获取、是否作为建议提供，以及 MCP 客户端的名称和版本（例如 claude-code/2.1.179）；
• suggest_prompts 会发送 Claude 提供的任务描述（最多 2,000 个字符），以便服务端与您的库进行匹配；该端点不会记录或存储这段文本。上述钩子不会执行此操作；
• save_prompt 和 update_prompt 会发送你要求保存的文本。

功能限制。 写入操作仅支持新增：服务端没有删除工具，重复保存相同文本不会产生变化；看起来像秘密的信息（API 密钥、令牌、私钥）会被拒绝——错误信息会指出秘密的类型，但不会显示其值。你保存的提示词会存放在你的 PromptLikeEngineer 账户中；有关服务如何处理这些内容，请参阅其 隐私政策和条款。

故障排除

你看到的内容	处理方法
"Not logged in. Run ple login in a terminal first (install: npm i -g promptlike)."	运行一次 npm i -g promptlike && ple login，然后再次提问。工具会在下次调用时使用新的会话；斜杠命令和 @ 资源会在服务连接时列出，如果缺少这些内容，请启动新的 Claude Code 会话
"Session expired. Run ple login in a terminal to sign in again."	再次运行 ple login
"Rate limited. Retry in 12s."	等待相应时间后再次提问
"Cannot reach https://promptlikeengineer.com. Check your connection." or "No response from https://promptlikeengineer.com within 15s."	检查网络连接并重试
"… Plan limit reached — nothing was saved. Upgrade: …"	你的套餐额度限制了保存操作，内容没有发生任何变化
claude mcp list 显示 plugin:promptlike:promptlike 连接失败	服务需要 Node.js 18 或更高版本、PATH 中有 npx，并且首次运行时能够访问 npm registry。在终端中运行 npx -y [email protected]：启动时会显示 promptlike-mcp v0.5.0 ready (stdio).（按 Ctrl-C 停止），无法启动时则会显示错误信息
没有出现建议说明	钩子需要 PATH 中有 ple CLI。对于斜杠命令、少于 20 个字符的消息、匹配度较低的内容、此会话中已建议过的提示词，以及关闭建议功能时，钩子都不会显示内容：ple config get suggest 可查看该功能是否已开启

可自托管

使用 PROMPTLIKE_API_URL 指向其他部署（与 CLI 使用的环境变量相同）。

支持与安全

问题和 Bug 报告：请在 https://github.com/zeynepaslierhann/promptlike-plugin/issues 提交 issue，或发送邮件至 Zeynep Aslı Erhan · [email protected]。请通过邮件报告安全问题，而不要在公开 issue 中报告。此代码仓库仅包含插件文件；MCP 服务是 npm 软件包 promptlike-mcp，用于登录的 CLI 是 promptlike，两者均采用 MIT 许可证。

链接

• 产品：https://promptlikeengineer.com/?utm_source=github&utm_medium=readme&utm_campaign=ple_dist
• 文档：https://promptlikeengineer.com/docs/mcp
• 隐私政策：https://promptlikeengineer.com/privacy · 条款：https://promptlikeengineer.com/terms
• npm 上的 MCP 服务：https://www.npmjs.com/package/promptlike-mcp
• npm 上的 CLI：https://www.npmjs.com/package/promptlike

采用 MIT 许可证。