关于 Velven
Velven 的技能、插件和 MCP 服务用于发布及管理 AI 构建的互动空间。它支持创建预览或正式页面、管理版本，并为已发布空间接入登录、排行榜、存档、成就和房间功能。
主要功能
- 01发布预览或正式空间
- 02管理空间与版本
- 03回滚到先前版本
- 04搜索 Velven 文档
- 05接入登录、排行榜和存档
适用场景
- 01将浏览器游戏发布为预览或正式页面
- 02查看并管理已发布空间
- 03为互动项目添加排行榜或成就
MCP 相关
Velven 提供 Streamable HTTP MCP 服务，支持发布空间、查看个人空间与版本、回滚及搜索文档。未登录时发布会生成未列出的页面和认领令牌；账户工具需 OAuth 登录。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
https://mcp.velven.ai/mcpclaude mcp add --transport http velvenai-velven https://mcp.velven.ai/mcp{"mcpServers":{"velvenai-velven":{"type":"http","url":"https://mcp.velven.ai/mcp"}}}在 Cursor 中打开{"servers":{"velvenai-velven":{"type":"http","url":"https://mcp.velven.ai/mcp"}}}在 VS Code 中打开{"mcpServers":{"velvenai-velven":{"type":"http","url":"https://mcp.velven.ai/mcp"}}}{"mcpServers":{"velvenai-velven":{"serverUrl":"https://mcp.velven.ai/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
5| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sdk | boolean | 否 | 在入口页面中添加 Velven 的 SDK 脚本。默认值为 true。 |
| spa | boolean | 否 | 对任何未知路径都提供入口页面（单页应用）。 |
| clip | string | 否 | 视频在悬停时无声播放。请提供已发送文件之一的路径：MP4 或 WebM 文件，大小不超过 3 MB，时长为 5 到 10 秒。Velven 随后不会自行录制片段。如果没有缩略图，片段的第一帧将作为图片。画面必须展示空间本身。时长不在此范围内的片段将被拒绝。如果文件未标明时长，Velven 会在线测量一次。对于较长的片段，它会保留前 10 秒；较短的片段则会被丢弃。后续版本若两者都未命名，则保留该空间的…… |
| html | string | 否 | 将完整页面作为一个 HTML 字符串发布，并命名为 index.html。 |
| prod | boolean | 否 | 直接在 space 的 Velven 页面上线，而不是创建预览。仅限已登录用户。默认值为 false。 |
| claim | string | 否 | 未列出页面的认领令牌：发布其下一个版本，或在登录后认领该页面。 |
| entry | string | 否 | 如果不是 index.html，则为首先打开的页面。 |
| files | object | 否 | 相对路径对应的文件：文本以字符串形式提供，二进制文件以 { "base64": "..." } 形式提供。必须包含入口页面（除非 entry 另有说明，否则为 index.html）。任何目录中的 velven.json、点文件、点目录或 node_modules 都会被排除（不会发布；结果会列出前 10 个并统计其余数量）：请将 velven.json 的设置作为此工具的字段发送。 |
| space | string | 否 | 发布此空间的新版本（你拥有此空间，且已登录）。 |
| title | string | 否 | 空间名称。创建新空间时必填。 |
| engine | enum | 否 | 绘制时使用的引擎（若为以下之一）。three.js | r3f | babylon.js | playcanvas | a-frame | godot | unity | phaser | p5.js | canvas | webgl | webgpu | wasm | dom | marble | spline | other |
| devices | array | 否 | 可在哪些设备上游玩。创建新空间时必填。 |
| thumbnail | string | 否 | 空间卡片上的图片。请提供已发送文件之一的路径：JPEG、PNG 或 WebP，最大 2 MB，每边最多 4096 像素。版本上线后会立即使用此图片，Velven 不会自行截图。图片必须展示空间本身。 |
| description | string | 否 | 名称下方的一行简介。 |
详细介绍
Velven 技能
适用于 Velven 的 Agent Skills（skills.sh 格式）、插件和 MCP 服务。Velven 是一个社区市场和托管平台，用于托管通过 AI 构建的空间。
onboard/教编码 Agent 如何在 Velven 上发布空间：velven publish会创建一个私密预览，--prod可在几秒内将其上线；即使创建者还没有账号，也能使用此功能（页面不会公开列出，并附带用于认领的令牌，以便保留页面）。它会根据项目填写velven.json，将已部署的网站作为备用路径进行关联，认领已在 Velven 上的空间，并通过 Velven SDK 添加登录、排行榜、保存、成就和房间功能。plugins/velven/是同一项技能，附带 Velven 的 MCP 服务，可作为 Claude Code 和 Codex 的插件使用。
安装
仅安装技能，适用于任何能读取 skills.sh 技能的 Agent：
npx skills add velvenai/skills
Claude Code，安装插件（技能和 MCP 服务）：
/plugin marketplace add velvenai/skills
/plugin install velven@velven
Codex：将此仓库添加为插件市场（.agents/plugins/marketplace.json），然后安装 velven。
Gemini CLI，安装 MCP 服务：gemini extensions install https://github.com/velvenai/skills。
MCP 服务
https://mcp.velven.ai/mcp，使用 Streamable HTTP。工具包括：publish（发布一个 HTML 页面或几个文件，总大小不超过 3 MB，可包含可选的 thumbnail 和 clip：创建预览，或使用 prod: true 在几秒内上线）、my_spaces、versions、rollback 和 search_docs。未登录时，publish 会创建一个不公开列出的页面并返回其认领令牌；账号相关工具会要求你登录 Velven（OAuth）。任何支持添加远程 MCP 服务的客户端，都可以通过该地址添加，例如：
claude mcp add --transport http velven https://mcp.velven.ai/mcp
server.json 是其在 MCP Registry 中的条目（io.github.velvenai/velven）。
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。