artifyde-mcp

artifyde-mcp

通过 MCP，为 Agent 的 HTML 成品提供永久存放处。

你的 Agent 会生成真正完成的 HTML 成品：仪表板、原型、报告、演示文稿。通常，这些内容都是临时的——一个会失效的 localhost 链接、文件夹里的一个文件，下一次运行时就消失了。这个 Model Context Protocol 服务会在 Artifyde 上为每个成品提供永久存放处：一个稳定的链接，任何人都可以打开、分享、标注，并在每次重新发布时创建新版本，而且无需让 Agent 离开其 MCP 宿主。

它封装了 Artifyde API，因此任何支持 MCP 的客户端（Claude Desktop、Claude Code、Cursor 等）都可以直接发布和管理成品。

安装

该服务通过 stdio 运行，并使用 npx 启动，因此无需全局安装。将其添加到 MCP 宿主的配置中。

Claude Code

claude mcp add artifyde --scope user -e ARTIFYDE_TOKEN=vk_your_login_token -- npx -y artifyde-mcp

如果你已经在使用 artifyde CLI，可以直接从其存储中读取令牌，无需粘贴：

claude mcp add artifyde --scope user \
  -e ARTIFYDE_TOKEN="$(jq -r '.servers["https://artifyde.com"].token' ~/.config/artifyde/config.json)" \
  -- npx -y artifyde-mcp

--scope user 可让所有项目都使用该配置；去掉此参数，则只为当前项目添加配置。重启 Claude Code（或运行 /mcp）即可查看工具。

Claude Desktop

安装一键安装包：从最新版本下载 artifyde-mcp.mcpb 并打开（Settings → Extensions），然后在扩展的设置中粘贴令牌。也可以将下面的 JSON 代码块添加到 claude_desktop_config.json。

OpenAI Codex

codex mcp add artifyde --env ARTIFYDE_TOKEN=vk_your_login_token -- npx -y artifyde-mcp

也可以在 ~/.codex/config.toml 中配置（Codex CLI 和 IDE 扩展共用）：

[mcp_servers.artifyde]
command = "npx"
args = ["-y", "artifyde-mcp"]

[mcp_servers.artifyde.env]
ARTIFYDE_TOKEN = "vk_your_login_token"

Cursor / 其他 MCP 宿主

任何接受 mcpServers JSON 代码块的宿主均可使用：

{
  "mcpServers": {
    "artifyde": {
      "command": "npx",
      "args": ["-y", "artifyde-mcp"],
      "env": {
        "ARTIFYDE_TOKEN": "vk_your_login_token"
      }
    }
  }
}

身份验证

在 env 中设置一个凭据：

• ARTIFYDE_TOKEN — 用户专属的登录令牌（vk_…）。安装 CLI（npm i -g artifyde-cli）、运行 artifyde login，然后从 ~/.config/artifyde/config.json 中复制令牌即可获取。推荐使用此选项：服务将以你的身份运行。
• ARTIFYDE_API_KEY — 管理员共享所有者密钥（适用于可自托管实例上的程序化身份或 Agent 身份）。如果两者都已设置，Bearer 令牌优先。

即使没有凭据，服务仍会启动并读取公开页面；发布和访问私有内容则需要凭据。

默认情况下，服务会连接托管实例 https://artifyde.com。使用 ARTIFYDE_URL 可将其指向其他地址（例如，可自托管或预览实例）。

工具

工具	功能
push_artifact	发布 HTML → 生成稳定的查看网址。重新推送到某个 page_id 可添加新版本。
pull_artifact	下载某个版本的逐字节一致 HTML。
get_page	获取页面元数据和版本历史记录。
list_pages	列出你的页面，包含版本数/评论数（可按归档状态或查询条件筛选）。
rename_page	设置页面的显示标题。
archive_page / unarchive_page	隐藏/恢复页面（归档后为只读）。
get_share	获取页面的可见性和受邀邮箱列表。
set_visibility	将页面设为 public 或 private。
share_page / unshare_page	邀请/撤销某个邮箱对私有页面的访问权限。
list_comments	读取页面的评论串。
create_comment	在某个版本上发表评论（或回复）。
list_shelves / create_shelf	管理图库分组。
add_page_to_shelf / remove_page_from_shelf	将页面整理到不同的书架中。
whoami	查看服务通过身份验证使用的身份。

每个工具都带有 readOnlyHint/destructiveHint/idempotentHint 注释，便于宿主按需控制确认流程。

隐私

此服务是 Artifyde API 的轻量客户端：它只会传输你要求它传输的数据（你发布的 HTML、页面 ID、评论文本、分享邮箱），并通过 HTTPS 发送到你配置的 Artifyde 服务（默认为 https://artifyde.com）。令牌从环境变量（或 Claude Desktop 扩展的配置）中读取，仅用于验证这些 API 调用；不会记录或发送到其他任何地方。有关托管服务如何处理你的数据，请参阅 Artifyde 隐私政策。

开发

bun install
bun test              # unit tests (Bun's built-in runner)
bun run typecheck     # tsc --noEmit
bun run start         # run from source over stdio
bun run bundle        # build the Claude Desktop .mcpb bundle

src/core/ 下的 Artifyde API 客户端来自（私有）Artifyde 单体代码库中的 @artifyde/core 包；它封装的 API 接口是服务稳定的 /v1 契约。

有关发布和市场列表的操作流程，请参阅 PUBLISHING.md。

支持

问题和疑问：github.com/kennethkoontz/artifyde-mcp/issues