mcpField
M
mcpship: check and publish MCP servers

mcpship: check and publish MCP servers

本地服务
github.com/emanueltns开发工具04 周前更新
代码仓库

关于 mcpship: check and publish MCP servers

mcpship 是一款 CLI，用于按 Claude connector 目录规则检查远程 MCP 服务，并引导发布到 npm、MCP Registry、插件仓库和目录。它面向服务维护者，也可作为本地 MCP 服务供 Agent 执行发布流程。

主要功能

  1. 01检查身份验证、工具和目录规则
  2. 02生成目录提交文案
  3. 03指引下一项发布步骤
  4. 04跟踪多个渠道的发布状态
  5. 05作为本地 MCP 服务运行

适用场景

  1. 01提交目录前检查服务
  2. 02准备目录表单文案
  3. 03跟进多个渠道的发布进度

MCP 相关

mcpship 可通过 stdio 在本地作为 MCP 服务运行。其插件为 Claude Code 提供 mcpship 工具和技能。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "emanueltns-mcpship": {
      "command": "npx",
      "args": [
        "-y",
        "mcpship"
      ]
    }
  }
}
启动命令npx -y mcpship

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmmcpship0.1.0

工具

5

收录的工具列表 · 更新于 3 周前

参数类型必填说明
dirstring否存放 publish.json 的文件夹。默认为启动服务器时所在的文件夹。
urlstring否服务器 URL。默认使用 publish.json 中的 server_url。

详细介绍

mcpship

检查远程 MCP 服务是否符合 Claude 连接器目录规则，然后发布到 npm、官方 MCP Registry、Claude Code 插件仓库和 Claude 连接器目录。一步一步来，适用于人和 Agent。

快速开始

npx mcpship init https://example.com/mcp   # 写入 publish.json；填写各字段
MCPSHIP_TOKEN=<访问令牌或 API 密钥> npx mcpship check
npx mcpship next                            # 下一步及其准确命令

命令

命令功能
init <url>在当前文件夹中写入 publish.json 模板
check [url]测试登录发现、工具和列表；任何规则检查失败时，退出代码为 1
packet写入 docs/directory/submission.md：目录表单各步骤的文本
next显示第一个未完成的步骤，以及对应命令或点击操作
status实时查看 npm、MCP Registry、插件仓库和目录的状态
done directory记录你已提交目录表单
mcp通过 stdio 作为本地 MCP 服务运行

添加 --json 可输出机器可读格式；添加 --dir <path> 可指定其他文件夹。

只有当你是软件包的维护者时，npm 才会被视为已发布。mcpship 会询问 npm whoami；如果你使用令牌而不是 npm login 发布，请在 publish.json 中将 channels.npm.maintainer 设为你的 npm 用户名。

check 检查的内容

规则失败条件
auth.https服务 URL 不是 https
auth.www-authenticate未经身份验证的调用未返回带有 resource_metadata 的 401
auth.resource-metadata缺少受保护资源元数据，或其中没有授权服务器
auth.as-metadata缺少授权服务器元数据
auth.pkce不支持 S256
auth.client-registration既不支持动态客户端注册，也不支持客户端 ID 元数据文档
tools.reachable使用给定令牌时，tools/list 调用失败（未提供令牌时跳过）
tools.title工具没有标题
tools.annotations工具既没有 readOnlyHint，也没有 destructiveHint
tools.instructions描述告知模型该做什么（“先使用它”“你必须”“调用 X”）
tools.hidden-text描述包含不可见字符或编码文本
listing.icon-url图标 URL 不是公开的 https PNG
listing.pages文档、隐私或条款页面无法加载
listing.lengths名称、单行简介或描述超过表单字数限制，或字段为空
listing.unpublished-mention页面要求用户在 npm 尚未发布时运行 npx <package>

警告：tools.mentions（描述提及其他工具）和 listing.em-dash。

在 Claude Code 中使用

/plugin marketplace add emanueltns/mcpship
/plugin install mcpship@mcpship

然后请 Claude 发布你的 MCP 服务。该插件会添加 mcpship 工具和一项引导你完成每个步骤的技能。

隐私

mcpship 在你的机器上运行。它会调用你的服务、publish.json 中的 URL、MCP Registry API，以及 npm 和 gh 调用的任何内容。它不会发送遥测数据。MCPSHIP_TOKEN 从环境中读取，且绝不会打印出来。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。