跳转到主要内容

本地 MCP 服务器提交指南

更新于今天

这是一份完整指南,用于将您的本地服务器 (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/

# 验证每个工具恰好有一个注解

影响:这是我们检查的第一件事,也是修订请求最常见的原因。

其他推

这是否解答了您的问题?