导入和发布
- 以管理员身份打开仪表盘中的技能页面,默认显示已安装。
- 点击手动导入,在弹窗中选择包含
SKILL.md的本地文件夹,或输入公开 GitHub 文件夹或 skills.sh 技能链接。切换到发现会自动加载 skills.sh 累计安装榜的前 20 项,也可以搜索并选择技能导入。 - 点击已安装技能的名称进入详情。文件浏览器默认打开
SKILL.md,支持预览不超过 512 KiB 的 Markdown、UTF-8 文本、PNG 和 JPEG 文件。在详情页打开启用并选择发布范围,改动会自动保存。勾选全局端点后,启用了全局路由的/mcp可以发现该技能。所选分组的端点沿用现有路由认证和分组可见性。 - 将兼容的客户端接入发布端点。客户端通过
skills/list发现技能、通过skills/get获取清单、通过resources/read读取文件。
HTTPS_PROXY 或 HTTP_PROXY 并遵循 NO_PROXY,两者均未配置时直接连接。也可以指定直接连接,或手动填写 HTTP(S) 代理地址。发现列表和搜索沿用服务端默认的网络配置。
发现功能使用 skills.sh 的公开目录接口,支持来源为公开 GitHub 仓库的技能。导入时从仓库默认分支定位技能,并固定到当时的提交。若有多个匹配目录,请输入具体的 GitHub 文件夹 URL,例如 https://github.com/owner/repo/tree/main/skill-name。也可以使用提交 SHA,或对分支和标签名中的斜杠进行 URL 编码。
目录名必须与 SKILL.md 中的 name 一致,并且在技能目录中唯一。每项技能支持最多 512 个普通文件,文件总大小不超过 16 MiB。GitHub 来源在导入时固定到一个提交。取消启用或删除技能即可撤下发布内容。
使用 TypeScript SDK 时,创建客户端时指定 versionNegotiation: { mode: "auto" },以发现 2026-07-28 端点。
存储与兼容性
每项技能保存在 MCPHub 工作目录下的data/skills/<技能名>/。目录中包含原始的 SKILL.md、按原相对路径保存的附件,以及保留给 MCPHub 的元数据文件 .mcphub.json。备份时请包含 data/skills/。Docker 部署时挂载 /app/data 以持久化这些目录。单实例自托管部署支持两种设置后端。
首次访问技能目录时,MCPHub 会迁移 data/skills/ 和 <设置文件>.skills/ 中的预览版 JSON 快照,保留 ID 和发布设置。有同名快照时,已有目录或第一个迁移的快照保留该名称,其余快照以 .conflict 文件保留在原目录,供手动恢复。
文件清单和 SHA-256 摘要对应原始 UTF-8 或二进制字节。如果技能在获取清单后更新,客户端可刷新清单并校验新文件。原有工具、提示词和资源继续通过各自的服务方法访问。