/ 目录 / 演练场 / pinme
● 社区 glitternetwork ⚡ 即开即用

pinme

作者 glitternetwork · glitternetwork/pinme

无需配置,通过一条 CLI 命令即可将前端部署到 IPFS —— 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 部署
    构建这个 Astro 网站并通过 pinme 部署它。✓ 已复制
    → Claude 运行构建,检测 dist/,安装 pinme(如果缺失),运行上传
  2. 获取链接
    (无需提示 —— 等待即可)✓ 已复制
    → 预览链接在聊天中返回

结果: 一个可分享的 IPFS 托管预览。

注意事项
  • 检测到错误的文件夹(例如同时存在 dist/ 和 build/) — 明确告诉 Claude:'upload from build/'
  • IPFS 网关首次加载缓慢 — 这是预期的 —— 后续加载会被缓存
搭配使用: filesystem

运行审查周期,每次迭代都获得新的预览链接

👤 审查 Claude 生成的 UI 的设计师 beginner

何时使用: 你在迭代原型,并希望每个版本都可链接。

步骤
  1. 每次更改后构建和部署
    每次我说'ship',就重新构建并通过 pinme 上传,然后发布链接。✓ 已复制
    → Claude 形成构建 → 部署 → 链接的节奏

结果: 可链接的迭代预览历史。

注意事项
  • 每次部署 IPFS CID 都会改变(预期) — 如果想要稳定的 URL,使用 ENS 或 DNSLink
搭配使用: filesystem

组合

与其他 MCP 搭配,撬动十倍杠杆

pinme-skill + filesystem

Claude 编写或编辑网站,然后通过 pinme 部署,无需离开会话

编辑 hero 文案,重新构建,然后 pinme upload dist —— 给我新的链接。✓ 已复制
pinme-skill + github

提交更改并一次性发布预览链接

在分支上提交更改,通过 pinme 部署,并将预览链接放在 PR 描述中。✓ 已复制

工具

此 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 很小
费用
提供免费层;更大/更持久的固定有付费层
提示
让测试预览过期;只长期固定生产 URL。

安全

权限、密钥、影响范围

凭据存储: 匿名上传无需凭据。固定持久化可选账户密钥。
数据出站: 上传的包发送到 IPFS —— 公开设计。永远不要上传密钥、.env 文件或非公开资源。

故障排查

常见错误与修复

pinme: command not found

Skill 应该会安装它;如果被阻止,请手动运行 npm i -g pinme

验证: pinme --version
上传卡住

检查网络;某些企业防火墙可能会阻止 IPFS bootstrap 节点。

上传了错误的文件夹

传递明确的路径:pinme upload ./dist 而不是依赖自动检测。

替代方案

pinme 对比其他方案

替代方案何时用它替代权衡
Vercel / Netlify想要自定义域名、无服务器函数或 CI 集成功能更多,需要账户和配置
GitHub Pages你的代码在 GitHub 上,并想要一个稳定的 github.io 链接与仓库绑定;部署循环较慢

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills