关于 Ownhand
Ownhand 是供 Agent 使用的远程 MCP 服务,可按个人写作风格和具体场合起草文本。它从用户提供的文字及对草稿的反馈中学习。
主要功能
- 01按学习到的风格改写草稿
- 02根据场合和收件人调整文本
- 03从已发送文本的反馈中学习
- 04管理写作样本和已学规则
- 05创建和编辑自定义场合
适用场景
- 01以个人风格起草 Slack 私信
- 02为特定收件人准备陌生开发邮件
- 03按写作风格改写 PR 描述
MCP 相关
提供用于写作、反馈和管理 Hand 的远程 MCP 工具,以及设置提示词和指南资源。它通过 Streamable HTTP 连接,并使用 OAuth 2.1 登录。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://ownhand.dev/mcpclaude mcp add --transport http jordan-gibbs-ownhand https://ownhand.dev/mcp{"mcpServers":{"jordan-gibbs-ownhand":{"type":"http","url":"https://ownhand.dev/mcp"}}}在 Cursor 中打开{"servers":{"jordan-gibbs-ownhand":{"type":"http","url":"https://ownhand.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"jordan-gibbs-ownhand":{"type":"http","url":"https://ownhand.dev/mcp"}}}{"mcpServers":{"jordan-gibbs-ownhand":{"serverUrl":"https://ownhand.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Ownhand
写出你风格的文字。
Ownhand 是一款远程 MCP 服务,能按照你自己的语气撰写文本,并适配文本的使用场景:Slack 私信、冷邮件或 PR 描述。它会从你写过的内容中学习你的语气,例如由你的 Agent 在你同意后提取约 20 封已发送的邮件或 Slack 消息,或由你粘贴 5 到 10 条内容,之后还会根据你实际发送的内容持续学习。
- 端点:
https://ownhand.dev/mcp(可流式传输的 HTTP) - 登录:使用动态客户端注册的 OAuth 2.1。添加 URL,在浏览器中登录,选择你的 Hand,然后点击 Allow。无需复制 API 密钥。
- 新账户可获得 $1 的免费额度。
用一句话完成设置
将以下内容粘贴到任意 Agent(Claude Code、Codex、Cursor、Gemini CLI 等)中。它会添加服务、启动登录流程并设置你的 Hand。
Fetch and execute the instructions to set me up for Ownhand from https://ownhand.dev/agent-setup/prompt.md. If your web tool can't open it, download it with curl or Invoke-WebRequest.
按客户端安装
| 客户端 | 安装 | 接下来 |
|---|---|---|
| Claude Code | claude mcp add --transport http --scope user ownhand https://ownhand.dev/mcp | 运行 /mcp,选择 ownhand 并登录。 |
| Claude Code 插件 | /plugin marketplace add jordan-gibbs/ownhand 然后 /plugin install ownhand@ownhand | 添加服务和 ownhand 技能。运行 /mcp 登录。 |
| Claude(claude.ai、桌面版、移动版) | Settings,Connectors,Add custom connector,粘贴 https://ownhand.dev/mcp | 点击 Connect 并登录。 |
| ChatGPT | 在 Settings 中开启 Developer mode,然后添加连接器并填入 https://ownhand.dev/mcp | 按提示登录。 |
| Cursor | 点击上方的 添加到 Cursor,或将 examples/cursor.mcp.json 放入 ~/.cursor/mcp.json | 点击 ownhand 旁边的 Connect。 |
| VS Code(Copilot) | 点击上方的 添加到 VS Code,或运行 code --add-mcp '{"name":"ownhand","type":"http","url":"https://ownhand.dev/mcp"}' | 按提示登录。 |
| Codex CLI | codex mcp add ownhand --url https://ownhand.dev/mcp | 如果未打开浏览器,请运行 codex mcp login ownhand。如果 Codex 正在运行,请重启(codex resume --last)。 |
| Gemini CLI | gemini mcp add --transport http --scope user ownhand https://ownhand.dev/mcp,或运行 gemini extensions install https://github.com/jordan-gibbs/ownhand | /mcp auth ownhand |
| Windsurf | 将 examples/windsurf.mcp_config.json 放入 mcp_config.json(使用 serverUrl) | 按提示登录。 |
| Zed | 将 examples/zed.settings.json 放入 Zed 设置 | 按提示登录。 |
| Goose | 运行 goose configure,添加一个使用该 URL 的远程扩展(可流式传输的 HTTP) | 按提示登录。 |
| Cline | examples/cline_mcp_settings.json(使用 "type": "streamableHttp") | 点击以登录。 |
| 其他 | 在 https://ownhand.dev/mcp 添加名为 ownhand 的远程可流式传输 HTTP 服务 | 按提示登录。 |
如果你想自行打开,以下是原始安装深层链接:
cursor://anysphere.cursor-deeplink/mcp/install?name=ownhand&config=eyJ1cmwiOiJodHRwczovL293bmhhbmQuZGV2L21jcCJ9
vscode:mcp/install?%7B%22name%22%3A%22ownhand%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fownhand.dev%2Fmcp%22%7D
vscode-insiders:mcp/install?%7B%22name%22%3A%22ownhand%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fownhand.dev%2Fmcp%22%7D
goose://extension?url=https%3A%2F%2Fownhand.dev%2Fmcp&type=streamable_http&id=ownhand&name=Ownhand&description=Write+in+your+own+voice
更多配置(包括 VS Code(.vscode/mcp.json)和 Codex(config.toml))请参见 examples/。此表的在线版本位于 https://ownhand.dev/connect。
脚本和 CI
对于不支持浏览器登录的客户端,文档中介绍了 API 密钥选项:https://ownhand.dev/docs#connect
首次运行
连接后,请说:“设置我的 Ownhand Hand。” 如果 Agent 有电子邮件或 Slack 工具,它会先征求你的同意,然后提取大约 20 条你发送过的消息,并跳过你未撰写的内容。你也可以粘贴 5 到 10 条自己写的内容(Slack 消息、电子邮件、PR 描述)。它还会询问你如何描述自己的写作风格,然后调用 create_hand。样本较少时也能使用 Hand,但在积累大约 5 到 20 条真实样本或从你的反馈中学习之前,生成的内容会比较泛泛。支持显示 MCP 提示词的客户端也会列出 set_up_my_hand。
Ownhand 适用于任何以你自己的名义发送的内容,即使你没有提及它。它不适用于代码、笔记或摘要,而且你可以在任何对话中选择不使用。为了让不具备记忆功能的客户端也能养成使用习惯,请将 AGENTS.md 粘贴到你的 CLAUDE.md、AGENTS.md、.cursorrules 或自定义指令中。
工具
| 工具 | 功能 |
|---|---|
write | 改写草稿,使其读起来像是你写的,并适合当前场合。保留所有事实。返回文本和一个 request_id。 |
send_feedback | 报告你如何处理草稿(approved、edited 并附上实际发送的完整文本,或 rejected),以便 Hand 学习。 |
get_hand | 列出你的 Hands,或显示其中一个 Hand 学到的内容:风格卡片、规则和样本数量。使用 show_samples 时,会列出样本本身。 |
create_hand | 根据你自己撰写的文本创建 Hand。 |
update_hand | 添加或移除样本,设置你对写作风格的描述,固定、拒绝或启用学到的规则,添加、编辑或移除自定义场合,添加、编辑或移除联系人,或回滚到较早的版本。 |
delete_hand | 永久删除 Hand 及其历史记录。 |
get_account | 显示你的账户、余额、近期扣费和用量。 |
提示词:set_up_my_hand、teach_my_voice、reply_to_thread、draft_email。
资源:ownhand://guide(Agent 操作指南)、ownhand://occasions(场合表)。
已知时,Agent 应将 recipient_name、recipient_email 和 recipient_notes 传给 write,让草稿更符合收件人的情况。update_hand 可以添加、编辑或移除联系人。
Agent 应通过 get_hand 检查 custom_occasions,并在适用时优先使用自定义场合。可通过 update_hand 添加、编辑或移除自定义场合。
场合:chat_dm、chat_channel、email_internal、email_formal、email_cold、email_warm、proposal_cold、proposal_warm、pr_description、review_comment、docs、status_update。
学习方式
- 你的 Agent 调用
write并向你展示草稿。未经你同意,不会发送任何内容。 - 你可以原样发送、编辑后发送,或放弃发送。
- 你的 Agent 使用你实际发送的完整文本调用
send_feedback。 - Ownhand 会比较草稿与你发送的内容,并更新你的 Hand。你发送反馈后,系统会用一两分钟进行一轮学习,将你的修改和理由转化为待确认的规则;确认后,这些规则才会生效。你陈述的理由属于有力证据,但学习不会立即完成。编辑 Hand 时,其版本号也会增加,因此不要将版本号变化视为学习已完成的标志。
你可以通过 update_hand 固定或拒绝任何学到的规则。从你的反馈中学习,只会更改你自己的 Hand。
定价
起步时可免费使用 $1 额度。之后,你可以充值并按使用的令牌付费,每次改写约半美分。无订阅,也无月费。详情:https://ownhand.dev/pricing。
隐私
- 存储:你的账户详情、Hands(样本、风格卡片、学习到的规则)、你的请求以及你发送的反馈。
- 记录:你的 Agent 调用了哪些工具、每次调用是否成功、耗时多久以及由哪个应用发起,但绝不记录调用内容。90 天后删除。
- 不存储:你的 Agent 作为上下文传递的线程消息。它们仅用于处理对应请求。
- 不出售、不共享用于广告,也不用于训练我们自己的模型。
- 写作和学习通过 OpenRouter 的贡献者套餐使用 Muse Spark,因此服务提供商可能会使用 Ownhand 处理的所有内容(草稿、样本、线程上下文、反馈)来改进其模型。请勿使用 Ownhand 处理你不希望被保留的文本。
- 你可以随时删除一个 Hand、撤销密钥或断开应用连接。
阅读完整政策:https://ownhand.dev/privacy。
文档
- 文档:https://ownhand.dev/docs
- Agent 指南:https://ownhand.dev/docs/agent-guide.md
- 连接:https://ownhand.dev/connect
- 面向 Agent:https://ownhand.dev/llms.txt
此仓库包含的内容
server.json:官方 MCP Registry 的入口.claude-plugin/、.mcp.json、skills/ownhand/:Claude Code 插件和市场gemini-extension.json、GEMINI.md:Gemini CLI 扩展AGENTS.md:适用于任何 Agent 的指令块examples/:客户端配置
许可证
此仓库中的配置和文档采用 MIT 许可证(参见 LICENSE)。Ownhand 服务本身为专有服务,由 Thalient Labs 运营。
联系邮箱:[email protected]
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。