English Français العربية

io.github.tempmd/mcp

السجل الرسمي أخرى

Publish artifacts to one stable public temp.md link that updates in place. No account needed.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http io-github-tempmd-mcp 'https://api.temp.md/mcp' --header 'Authorization: <Optional: Bearer followed by a temp.md account API key for account-owned publishing and account tools>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "io-github-tempmd-mcp": {
            "type": "http",
            "url": "https://api.temp.md/mcp",
            "headers": {
                "Authorization": "<Optional: Bearer followed by a temp.md account API key for account-owned publishing and account tools>"
            }
        }
    }
}
NPM package @tempmd/mcp
Claude Code 
claude mcp add io-github-tempmd-mcp -e 'TEMPMD_API_URL=<TEMPMD_API_URL>' -- npx -y @tempmd/mcp@0.4.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "io-github-tempmd-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@tempmd/mcp@0.4.3"
            ],
            "env": {
                "TEMPMD_API_URL": "<TEMPMD_API_URL>"
            }
        }
    }
}

متغيرات البيئة

  • TEMPMD_API_URL Override the temp.md API base URL (default: https://api.temp.md)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. @tempmd/mcp
  2. Install
  3. Tools
  4. How credentials work
  5. Configuration
  6. Development
  7. Semantics agents should preserve

@tempmd/mcp

MCP server for temp.md — give agent-made artifacts one stable public link that updates in place.

Publish an HTML, Markdown, CSV, or Mermaid artifact and get a canonical URL like amber-hill-9eb6.temp.md. Push new versions behind the same URL — no re-sharing, ever. Temps expire intentionally when the work goes cold (7-day active window, resets on every update) and can be restored within 7 days of expiry.

Install

Remote — no install

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

Remote MCP accepts inline UTF-8 or base64 files. Anonymous publishing needs no credential. To publish directly into an account and use account tools, configure the connection with Authorization: Bearer <tempmd_key_...>.

Local stdio — best for filesystem access and larger directories

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

Cursor / Windsurf / any MCP client — add to your MCP config:

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

tempmd-mcp remains available as a compatibility package with the same implementation and version.

No account or API key required — temp.md is anonymous-create-first. Claim a Temp later to keep it.

The remote transport is limited to 10 MiB and 20 inline files per bundle. The stdio package uses local paths and supports the full 50 MiB / 100-file bundle.

Tools

ToolLocal stdioRemoteWhat it does
publish_temp✓✓Publish a new artifact and get a stable public URL
update_temp✓✓Push a new version behind the same URL
get_temp_status✓✓Check lifecycle and restore eligibility
restore_temp✓✓Bring a recently expired Temp back at the same URL
snapshot_temp✓✓Freeze the current version as a fixed reference
set_comments✓✓Toggle pinned visitor comments
list_temps✓✓List local project records or account-owned Temps
recover_update_token—✓Rotate and recover a lost scoped update token

publish_temp and update_temp accept spa_mode: true for client-routed single-page apps. Leave it off for static sites so missing assets return 404. Uploads are capped at 10 MB per file, 50 MB per bundle, and 100 files; publish and update limits are 60/hour/IP and 120/hour/Temp/IP respectively.

How credentials work

publish_temp saves a record (Temp ID, URL, update token, expiry) to a .tempmd file in the project root. Every other tool reads that file automatically, so an agent can update the same Temp across sessions without you managing tokens. Tokens can also be passed explicitly via update_token.

Add .tempmd to .gitignore if the update token shouldn't be shared with everyone who can read the repo.

Configuration

Env varDefaultPurpose
TEMPMD_API_URLhttps://api.temp.mdPoint at a different API (e.g. local dev http://localhost:8787)

Development

This repo mirrors the packages/mcp package from the temp.md monorepo, where development happens. Issues and feature requests are welcome here.

Semantics agents should preserve

  • The canonical URL is the only link to share — never surface version-specific links.
  • A failed update never breaks the live link; the last successful version keeps serving.
  • Prefer update_temp over publish_temp when the project already has a Temp for the artifact.

الأسئلة الشائعة

ما هو io.github.tempmd/mcp؟

Publish artifacts to one stable public temp.md link that updates in place. No account needed.

كيف أثبّت io.github.tempmd/mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http io-github-tempmd-mcp 'https://api.temp.md/mcp' --header 'Authorization: <Optional: Bearer followed by a temp.md account API key for account-owned publishing and account tools>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.tempmd/mcp إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل io.github.tempmd/mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.tempmd/mcp؟

ينشره tempmd. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.