tempmd

@tempmd/mcp

面向 temp.md 的 MCP 服务——为 Agent 生成的产物提供一个稳定的公开链接，并在原链接下更新内容。

发布 HTML、Markdown、CSV 或 Mermaid 产物，即可获得类似 amber-hill-9eb6.temp.md 的规范 URL。通过同一个 URL 推送新版本，无需再次分享。Temp 会在工作不再活跃时按预期过期（活跃期为 7 天，每次更新都会重置），并可在过期后的 7 天内恢复。

安装

远程——无需安装

claude mcp add --transport http tempmd https://api.temp.md/mcp

远程 MCP 支持内联 UTF-8 或 base64 文件。匿名发布无需凭据。若要直接发布到帐户并使用帐户工具，请使用 Authorization: Bearer <tempmd_key_...> 配置连接。

本地 stdio——最适合访问文件系统和较大的目录

claude mcp add tempmd -- npx -y @tempmd/mcp

Cursor / Windsurf / 任意 MCP 客户端——添加到 MCP 配置中：

{
  "mcpServers": {
    "tempmd": {
      "command": "npx",
      "args": ["-y", "@tempmd/mcp"]
    }
  }
}

tempmd-mcp 仍作为兼容性软件包提供，采用相同的实现和版本。

无需帐户或 API 密钥——temp.md 优先支持匿名创建。之后可认领 Temp 以保留它。

远程传输限制为 10 MiB 和每个包 20 个内联文件。stdio 软件包使用本地路径，并支持完整的 50 MiB / 100 个文件包。

工具

工具	本地 stdio	远程	功能
publish_temp	✓	✓	发布新产物并获取稳定的公开 URL
update_temp	✓	✓	在同一个 URL 下推送新版本
get_temp_status	✓	✓	检查生命周期和是否符合恢复条件
restore_temp	✓	✓	在同一个 URL 下恢复最近过期的 Temp
snapshot_temp	✓	✓	将当前版本冻结为固定引用
set_comments	✓	✓	开启或关闭访客置顶评论
list_temps	✓	✓	列出本地项目记录或帐户拥有的 Temps
recover_update_token	—	✓	轮换并恢复丢失的受限更新令牌

对于由客户端路由的单页应用，publish_temp 和 update_temp 支持 spa_mode: true。静态站点请保持关闭，以便缺失的资源返回 404。上传限制为每个文件 10 MB、每个包 50 MB，且最多 100 个文件；发布和更新的速率限制分别为每小时每个 IP 60 次，以及每小时每个 Temp 每个 IP 120 次。

凭据的工作方式

publish_temp 会将一条记录（Temp ID、URL、更新令牌、过期时间）保存到项目根目录下的 .tempmd 文件中。其他所有工具都会自动读取该文件，因此 Agent 可以跨会话更新同一个 Temp，无需你管理令牌。也可以通过 update_token 显式传入令牌。

如果不希望所有能读取代码仓库的人都能共享更新令牌，请将 .tempmd 添加到 .gitignore。

配置

环境变量	默认值	用途
TEMPMD_API_URL	https://api.temp.md	指向其他 API（例如本地开发环境 http://localhost:8787）

开发

此代码仓库镜像了 temp.md 单体代码仓库中的 packages/mcp 软件包；开发工作在该单体代码仓库中进行。欢迎提交问题和功能请求。

Agent 应遵循的语义

• 规范 URL 是唯一应分享的链接——绝不要展示特定版本的链接。
• 更新失败不会影响线上链接；最后一个成功版本会继续提供服务。
• 如果项目已有对应产物的 Temp，优先使用 update_temp，而非 publish_temp。