/ 目錄 / 演練場 / pinme
● 社群 glitternetwork ⚡ 即開即用

pinme

作者 glitternetwork · glitternetwork/pinme

零設定前端部署至 IPFS,只需一個 CLI 指令 — Claude 執行 pinme upload dist 並回傳預覽網址。

PinMe 是一個 CLI + Claude Skill,可透過單一指令將靜態網站(dist/build/out/public)部署至 IPFS,無需帳號或伺服器。此 Skill 內含 AI Execution Protocol,讓 Claude 確切知道如何驗證 Node、安裝 CLI、偵測正確的建置資料夾,並將預覽網址回傳給使用者。

為什麼要用

核心特性

即時演示

實際使用效果

pinme-skill.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "pinme-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/glitternetwork/pinme",
        "~/.claude/skills/pinme"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "pinme-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/glitternetwork/pinme",
        "~/.claude/skills/pinme"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "pinme-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/glitternetwork/pinme",
        "~/.claude/skills/pinme"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "pinme-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/glitternetwork/pinme",
        "~/.claude/skills/pinme"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "pinme-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/glitternetwork/pinme",
        "~/.claude/skills/pinme"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "pinme-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/glitternetwork/pinme",
          "~/.claude/skills/pinme"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add pinme-skill -- git clone https://github.com/glitternetwork/pinme ~/.claude/skills/pinme

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: pinme

一分鐘內為登陸頁面產生預覽連結

👤 使用 Claude Code 迭代開發靜態網站的開發者 ⏱ ~3 min beginner

何時使用: 你想分享預覽連結,但不想設定 Vercel/Netlify,只需要一個原始連結。

前置條件
  • 已安裝 Node.js — node >= 18 — Skill 會自動驗證
  • 已建置好的靜態網站 — 執行你所用框架的建置指令(例如 npm run build)
步驟
  1. 請 Claude 進行部署
    Build this Astro site and deploy it with pinme.✓ 已複製
    → Claude 執行建置、偵測 dist/、若缺少 pinme 則安裝,並執行上傳
  2. 取得網址
    (no prompt — just wait)✓ 已複製
    → 預覽網址顯示於對話中

結果: 一個可分享的 IPFS 託管預覽連結。

注意事項
  • 偵測到錯誤的資料夾(例如同時存在 dist/ 和 build/) — 明確告知 Claude:'upload from build/'
  • IPFS 閘道首次載入較慢 — 此為預期行為 — 後續載入會從快取讀取
搭配使用: filesystem

進行審查循環,每次迭代都取得全新的預覽網址

👤 審查 Claude 生成介面的設計師 beginner

何時使用: 你正在迭代開發原型,並希望每個版本都有可分享的連結。

步驟
  1. 每次變更後建置並部署
    Every time I say 'ship', rebuild and upload via pinme, then post the URL.✓ 已複製
    → Claude 建立固定節奏:建置 → 部署 → 回傳網址

結果: 每次迭代版本皆有對應的預覽連結紀錄。

注意事項
  • 每次部署的 IPFS CID 都會變更(此為預期行為) — 若需穩定網址,請使用 ENS 或 DNSLink
搭配使用: filesystem

組合

與其他 MCP 搭配,撬動十倍槓桿

pinme-skill + filesystem

Claude 撰寫或編輯網站內容後,直接在同一個工作階段中透過 pinme 完成部署

Edit the hero copy, rebuild, then pinme upload dist — give me the new URL.✓ 已複製
pinme-skill + github

在同一輪對話中提交變更並產生預覽網址

Commit the change on a branch, deploy via pinme, and put the preview URL in the PR description.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
pinme upload <folder> folder path (dist/, build/, etc.) 部署靜態建置產物 Free tier available
Build-folder auto-detection current project directory 在上傳之前執行 0
Node version verification none 執行前置檢查 0

成本與限制

運行它的成本

API 配額
PinMe 免費方案有用量上限;請至 pinme.eth 查看目前限制
每次呼叫 Token 數
極少 — 此 Skill 體積很小
費用
提供免費方案;需要更大容量或更持久釘選的需求可升級付費方案
提示
讓測試用預覽連結自然過期;只將正式環境的網址進行長期釘選。

安全

權限、密鑰、影響範圍

憑證儲存: 匿名上傳無需任何憑證。可選擇性提供帳號金鑰以維持釘選持久性。
資料出站: 上傳的封包會進入 IPFS — 設計上即為公開存取。切勿上傳機密資訊、.env 檔案或非公開資產。

故障排查

常見錯誤與修復

pinme: command not found

Skill 應會自動安裝;若受阻可手動執行 npm i -g pinme

驗證: pinme --version
Upload hangs

請檢查網路連線;部分企業防火牆會封鎖 IPFS 啟動節點。

Wrong folder uploaded

請明確指定路徑:使用 pinme upload ./dist,而非依賴自動偵測。

替代方案

pinme 對比其他方案

替代方案何時用它替代權衡
Vercel / Netlify你需要自訂網域、Serverless 函式或 CI 整合功能更豐富,但需要帳號與額外設定
GitHub Pages你的程式碼在 GitHub 上,且希望擁有穩定的 github.io 網址與特定儲存庫綁定;部署循環較慢

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills