Dochost

dochost MCP 服务

English | 简体中文

直接从 AI 助手发布 Markdown 或 HTML，生成简洁、便于分享的链接。dochost MCP 服务为 Claude、ChatGPT、Cursor 和其他 MCP 客户端提供八种工具——publish、update_page、get_page_content、set_page_options、list_my_pages、get_page、get_account、delete_page——让助手可以返回一个公开的 dochost 链接，然后继续维护页面。无需复制粘贴，也无需单独使用控制面板。

• 🌐 网站：https://dochost.io
• 🔌 MCP 服务：https://dochost.io/mcp
• 🛰️ 端点：https://dochost.io/api/mcp（Streamable HTTP，OAuth）
• 🔑 身份验证：OAuth 登录——无需 API 密钥

为什么选择 dochost

你的大模型生成了一份报告、一个 README 或一个 HTML 作品。分享它不应该意味着只能发截图或原始 .md 文件。dochost 只需一次工具调用，就能将输出转换成拥有专属 URL 的普通网页。Markdown 和 HTML 都会实时渲染。

快速开始

Claude Code（一行命令）：

claude mcp add --transport http dochost https://dochost.io/api/mcp

然后在 Claude Code 中运行 /mcp，并在浏览器中批准。添加 --scope user，即可在所有项目中使用。

Gemini CLI（扩展）：

gemini extensions install https://github.com/zyli5313/dochost-mcp

或者在 ~/.gemini/settings.json 中添加远程 HTTP 服务：

{
  "mcpServers": {
    "dochost": {
      "httpUrl": "https://dochost.io/api/mcp"
    }
  }
}

Claude Desktop / Cursor / VS Code / Windsurf——添加远程 HTTP 服务：

{
  "mcpServers": {
    "dochost": {
      "type": "http",
      "url": "https://dochost.io/api/mcp"
    }
  }
}

你只需在浏览器中通过 OAuth 授权一次；之后，助手就会以你的身份发布内容，输出内容遵循你的 dochost 方案所包含的权益。

Stdio / Docker 桥接

对于需要本地 stdio 进程的客户端或目录评估工具，本仓库提供了一个连接到同一托管 MCP 端点的桥接程序：

npm ci --ignore-scripts
node server/index.js

或者在 Docker 中运行：

docker build -t dochost-mcp .
docker run --rm -i dochost-mcp

需要 Node.js 22 或更高版本。桥接程序会转发实时工具和架构；它不是 dochost 应用的可自托管副本。初始化和工具发现不需要身份验证。交互式客户端可以使用 OAuth；无头工具执行需要现有的 DOCHOST_API_KEY 运行时密钥（Docker：docker run --rm -i -e DOCHOST_API_KEY dochost-mcp）。

维护者请参阅 Glama 声明、构建和发布说明。

应使用哪种身份验证方式？

客户端	推荐的身份验证方式	原因
OpenClaw、Hermes	API 密钥	无头 Agent（例如 Telegram 编排器）。静态 Bearer 密钥可用于纯 HTTP 技能和任意 MCP 运行器，无需每次会话都在浏览器中操作。
Claude、Cursor、ChatGPT、VS Code、Windsurf 及所有其他 MCP 客户端	OAuth	只需在浏览器中批准一次，无需在配置中长期存储凭据；助手会以你的身份发布内容。

请像保管其他密钥一样保管 API 密钥：将其存储为环境变量或主机密钥（切勿提交到代码仓库）；如果密钥泄露，请在 Settings → API keys 中撤销或轮换。

Agent（OpenClaw、Hermes）——API 密钥

OpenClaw 和 Hermes 是无头程序，因此需要使用 API 密钥进行身份验证。在 dochost.io → Settings → API keys 中创建密钥，将其导出为 DOCHOST_API_KEY，然后选择以下任一方式：

• 安装技能——一个独立的 publish 技能，可用于任何能够发起 HTTP 请求的 Agent：skills/dochost-publish/。
• 接入 MCP——将 Agent 指向 https://dochost.io/api/mcp，并将密钥设为 Bearer 标头：examples/mcporter.config.json。

各主机安装指南：

• OpenClaw → clients/openclaw.md
• Hermes → clients/hermes.md

从 shell 一次性发布：examples/publish.sh。

工具

共有八种工具。publish 用于创建内容；其余工具让助手能够继续处理已发布的内容，这样你每次修改内容时，链接都不会被搁置。

publish

将 Markdown 或 HTML 发布为托管页面，并获取可分享的 URL。

参数	类型	说明
body	string（必填）	要发布的 Markdown 或 HTML 内容。
format	"markdown" | "html"	若省略，则自动检测。
public	boolean	是否在 Explore 中列出。默认为 false（未列出）。
customSlug	string · Pro	自定义链接路径，而不是使用随机 slug。
password	string · Pro	为页面设置密码保护。
noBranding	boolean · Pro	隐藏 dochost 页脚徽标。

返回 url、slug、expiresAt 和 editToken。

示例：“将我的 Q3 报告发布为带密码的私密页面。” → dochost.co/d/q3-report（需要密码，免费版链接有效期为 7 天）。

update_page

原位替换页面内容。URL、浏览量/点赞数和到期时间都会保留——只有 body、format 和 title 会改变。

参数	类型	说明
slug	string（必填）	要更新的页面。
body	string（必填）	新的 Markdown 或 HTML 内容。
format	"markdown" | "html"	若省略，则自动检测。
title	string	覆盖自动生成的标题。

修改已发布的内容时，优先使用此工具，而不是再次发布——第二次调用 publish 会生成第二个链接，让读者手中的原链接失效。重新发送相同内容不会产生任何更改。

get_page_content

根据 slug 读取自己某个页面的当前 Markdown 或 HTML。如果助手没有在同一对话中亲自编写当前线上内容，请在调用 update_page 前先调用此工具——update_page 会整体替换正文，因此凭记忆编辑会悄然丢弃其他地方做出的修改，包括在浏览器中的修改。 返回 version 和 sha256；将它们作为 ifVersion / ifSha 传给 update_page，这样如果页面已被修改，写入就会被拒绝，而不是覆盖助手未读取的更改。过期页面仍可读取，更新后会在相同 URL 上重新发布。

set_page_options

更改已发布页面的可见性、搜索引擎索引设置或密码，无需重新发布——URL、浏览量和内容都会保持不变。 参数：slug（必填）、public、searchable、password、removePassword；只发送要更改的字段。关闭付费功能不需要相应权益；启用付费功能时，会根据当前方案进行检查。设置密码后，页面始终为私密页面，因此同时请求 public: true 和设置密码会被拒绝。无法在此设置品牌选项。

list_my_pages

按发布时间从新到旧列出你发布的页面。支持分页（limit、offset）；返回不含页面正文的精简记录。

get_page

根据 slug 查询一个页面：标题、格式、状态、浏览量/点赞数、到期时间，以及是否受密码保护。绝不返回正文或密码。

get_account

查看你的方案、页面配额使用情况和权益标记（大小上限、自定义 slug、密码、品牌选项）。建议在调用 publish 前使用，以便助手提前了解限制，避免因超出限制而失败。

delete_page

根据 slug 永久删除页面。链接会立即失效，slug 也会被释放。删除已删除的页面不会产生任何影响。

说明

• 所有权和权益均来自经过身份验证的账户，而非工具输入。
• 已发布页面位于**dochost.co**，这是一个独立的无 Cookie 内容源——绝不会位于应用源 dochost.io 上。这样 dochost 就能在强化的策略下提供作者 HTML，而不影响你的会话。dochost.io/d/… 会永久重定向到 dochost.co/d/…，因此旧链接仍然有效。
• 免费链接有效期为 7 天；永久链接、密码、自定义 slug、自定义子域名和移除品牌选项均属于付费方案——请参阅 dochost.io。

链接

• 主页 — https://dochost.io
• MCP 设置与文档 — https://dochost.io/mcp

许可证

MIT — 参阅 LICENSE。