tempmd

@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、1 バンドルあたりインラインファイル 20 個です。stdio パッケージはローカルパスを使用し、最大 50 MiB／100 ファイルのバンドルに対応しています。

ツール

ツール	ローカル stdio	リモート	機能
publish_temp	✓	✓	新しい成果物を公開し、安定した公開 URL を取得します
update_temp	✓	✓	同じ URL のまま新しいバージョンを公開します
get_temp_status	✓	✓	ライフサイクルと復元可能かどうかを確認します
restore_temp	✓	✓	最近期限切れになった Temp を同じ URL で復元します
snapshot_temp	✓	✓	現在のバージョンを固定参照として保存します
set_comments	✓	✓	訪問者によるピン留めコメントのオン／オフを切り替えます
list_temps	✓	✓	ローカルプロジェクトの記録、またはアカウント所有の Temp を一覧表示します
recover_update_token	—	✓	紛失したスコープ付き更新トークンをローテーションして復旧します

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 に追加してください。

設定

環境変数	デフォルト	用途
TEMPMD_API_URL	https://api.temp.md	接続先の API を変更します（例：ローカル開発用の http://localhost:8787）

開発

このリポジトリは、開発が行われている temp.md モノレポの packages/mcp パッケージをミラーしています。ここでの課題報告や機能リクエストを歓迎します。

エージェントが守るべきルール

• 共有するリンクには正規 URL のみを使用し、バージョン固有のリンクは決して提示しないでください。
• 更新に失敗しても公開中のリンクには影響しません。最後に成功したバージョンの配信が続きます。
• 対象の成果物用の Temp がすでにある場合は、publish_temp より update_temp を優先してください。