tempmd-mcp

temp.md 的 MCP 服务器 — 为智能体生成的工件提供一个可原地更新的稳定公共链接。

发布 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 文件包。

Related MCP server: sentou

工具

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

凭据如何工作

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

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

配置

开发

此仓库镜像了 temp.md monorepo 中的 packages/mcp 包，开发工作在那里进行。欢迎在此提交问题和功能请求。

智能体应保留的语义

• 规范 URL 是唯一需要分享的链接 — 切勿展示特定版本的链接。

• 失败的更新绝不会破坏在线链接；最后一个成功版本会继续提供服务。

• 当项目已有该工件的 Temp 时，优先使用 update_temp 而不是 publish_temp。