ship-mcp

ship-mcp

用于构建 MCP 服务的简洁 TypeScript 起步模板。 使用 Zod 验证工具，配备单元测试，接入 MCP Inspector，一条命令即可启动开发循环。克隆项目，修改两个字符串，即可发布你的服务。

npx degit colossal1598/ship-MCP my-server && cd my-server && npm i && npm run dev

为什么要做这个项目

每个 MCP 服务的起步阶段都要花同样的 90 分钟进行设置：接入 SDK、配置 stdio 传输、验证架构、弄清楚为什么 console.log 会破坏协议（日志应输出到 stderr——这里已经处理好了），以及接入 Inspector。本仓库就是把这 90 分钟的工作一次性妥善完成。

包含内容

• src/index.ts — 服务配置：注册工具，连接 stdio 传输。约 40 行，没有魔法。
• src/tools.ts — 将工具逻辑与配置解耦，方便进行单元测试。包含两个示例：echo（hello-world）和 fetch_json（带错误处理的真实异步工具）。
• src/tools.test.ts — 无需启动服务即可运行的 Vitest 测试。
• npm run inspect — 启动官方 MCP Inspector，并连接到你的开发服务。

快速开始

npm install
npm run dev        # run the server (stdio)
npm test           # unit tests
npm run inspect    # poke tools in the MCP Inspector UI
npm run build      # compile to dist/

在 Claude Desktop / Claude Code 中使用

{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"]
    }
  }
}

添加你自己的工具（30 秒）

// src/tools.ts
export const greetInput = { name: z.string() };
export async function greet({ name }: { name: string }) {
  return { content: [{ type: "text" as const, text: `Hello, ${name}!` }] };
}

// src/index.ts
server.registerTool("greet", { description: "Greet someone", inputSchema: greetInput }, greet);

---

想发布一个付费 MCP 服务？

目前 11,000 多个 MCP 服务中，能赚钱的不到 5%——并非因为没有需求，而是因为计费配置确实令人头疼。Ship MCP Pro 是这个起步模板的升级版，包含免费版本特意省略的所有内容：

• 🔑 许可证密钥验证 — Payhip 和 Gumroad 许可证验证中间件；出售密钥，由服务进行验证
• 📊 用量计量 + 每个密钥的速率限制 — 开箱即用的免费层 / 付费层
• 🌐 可流式 HTTP 传输 — 部署为远程服务（包含 Docker + Railway/Fly 指南）
• ✅ CI 流水线、扩展测试套件、生产级错误处理
• 📣 发布套件 — 让服务安装量提升 10 倍的目录提交清单和上架模板

一次性支付 $49，MIT 许可的产出，免费更新。 → 获取 Ship MCP Pro

---

MIT © Argo Navis

关于 SDK 固定版本的说明： 此起步模板将 @modelcontextprotocol/[email protected] 精确固定为 2026-07-28 规范对应的 v2 SDK。稳定版 2.0.0 发布后，更新固定版本并重新运行测试；精确固定版本可以防止上游 beta 版本变更在不知情的情况下导致构建失败。