这是一份完整指南,用于将您的本地服务器 (MCPB) 提交到 Anthropic 的公共目录,以实现更广泛的分发和可发现性。
前置条件
阅读本指南前,您应该具备:
一个可工作的 MCPB
使用变量替换的可移植代码
良好的错误消息和用户体验
清晰、捆绑的依赖项
初次接触 MCPB 开发?请先查看使用 MCPB 构建桌面扩展。有关技术最佳实践(测试、错误消息、可移植性),请查看 MCPB 存储库。
注意:本指南涵盖本地 MCP 服务器。对于远程桌面扩展,请查看远程 MCP 服务器提交指南。
1. 目录概览
目录包含有什么好处?
可发现性和信任:
在 Claude Desktop 内的官方 Anthropic 目录中列出
可由个人 Claude Desktop 用户搜索
当管理员将其添加到允许列表时,对团队/企业用户可见
Anthropic 审查建立用户信任
用户体验:
从目录一键安装
与 Claude Desktop 设置 UI 集成
标准化呈现
支持和信誉:
Anthropic 对质量和安全性的审查
与其他已审查的扩展一起列出
社区可见性和反馈
专业分发渠道
2. 强制性要求
本部分中的所有要求对于目录批准都是强制性的。缺少其中任何一项将导致拒绝或修订请求。
注意:这些是 Anthropic 目录特定的要求。
有关一般 MCPB 开发最佳实践(测试、错误处理、可移植性),请查看 MCPB 存储库 README。
工具注解是否必需?
是的。每个工具都必须具有并维护准确的安全注解。
每个工具上必需的内容:
readOnlyHint: true - 用于仅读取数据的工具
destructiveHint: true - 用于修改数据或有副作用的工具
有关完整的架构和实现细节,请查看 MCP 协议 - 工具注解。
不可选。这是从 MCP 目录政策派生的硬性要求。
如何决定使用哪个注解:
工具行为 | 注解 | 示例 |
仅读取数据 | readOnlyHint: true | search、get、list、fetch、read |
写入/修改数据 | destructiveHint: true | create、update、delete、send、write |
创建临时文件 | destructiveHint: true | 即使是临时写入也算 |
发送外部请求 | destructiveHint: true | 电子邮件、通知、webhook |
仅内部缓存 | readOnlyHint: true | 内部优化可以 |
实现细节:有关以下内容,请查看 MCP 协议 - 工具:
带注解的完整工具架构
工具定义结构
输入/输出架构规范
其他工具属性(包括可选的 title 字段)
提交前验证:
# 检查所有工具是否有注解
grep -A 5 -B 5 "readOnlyHint\|destructiveHint" server/
# 验证每个工具恰好有一个注解
影响:这是我们检查的第一件事,也是修订请求最常见的原因。
其他推
