Content MCP（内容发布）

功能范围

Content MCP 用于通过 MCP 发布和维护 Synapse 内容资源。当前支持 Rule、Skill 和 Prompt 的查询、新建、更新和删除。

可用工具包括 content_type_describe，以及 content_rule_*、content_skill_*、content_prompt_* 三组资源工具。创建或更新前应先调用 content_type_describe 获取字段要求、分类、图标、背景色和限制。

Content MCP 只写入内容仓库，不负责安装到编辑器。安装仍通过 Synapse 的编辑器安装能力完成。

使用方式

列出或查看资源时，使用对应类型的 list 和 get 工具。更新或删除前，先调用 get，再把返回的 latestHistoryDirname 作为 baseHistoryDirname 传入 update 或 delete。

创建 Rule 时提供 name、title、description、category、content 和外观字段。创建 Prompt 时不需要 name。创建 Skill 时除基础字段外，可提供附件。

Skill 附件有两种方式：

• files：逐个传入相对路径和文本或 base64 内容。
• sourceDirectoryPath：导入一个本地 Skill 目录。

两种方式不能同时使用。使用 sourceDirectoryPath 时，Synapse 读取 Skill 主文件，导入非隐藏附件，并在未显式传字段时使用主文件 frontmatter 中的元数据。

外观与图片

使用内置图标时，设置 iconType 为 icon，并从 content_type_describe 返回的 icon 和 iconBg 值中选择。

使用图片时，设置 iconType 为 image，并提供 iconImagePath 或 iconImageBase64 中的一个。Synapse 会校验图片输入，将图片居中裁剪并缩放为 256 x 256 PNG，最终保存为 icon.png。

权限与限制

更新和删除只能作用于当前仓库身份创建的资源。若资源由其他用户创建，Content MCP 会拒绝修改。

MCP 更新和删除不支持 force。当 baseHistoryDirname 与最新版本不一致时，操作返回冲突信息，调用方需要重新读取最新内容后再决定如何处理。

Skill 附件会进行路径归一化、重复路径检查、大小检查和敏感文件名检查。附件路径应始终是相对路径，不应包含绝对路径或路径穿越。

内置 Skill

Synapse 内置 synapse-content-mcp Skill，用于指导 Agent 使用 Content MCP。该 Skill 会说明工具边界、默认流程、所有权规则、图片规则和 Skill 附件规则。