ship-mcp

ship-mcp

MCP サーバーを構築するための、すっきりとした TypeScript スターターです。 Zod によるツールの検証、ユニットテスト、MCP Inspector の設定、1 コマンドで完結する開発ループを備えています。クローンして、2 つの文字列を置き換えれば、サーバーを公開できます。

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 — ツールのロジックを設定から分離しているため、ユニットテストが可能です。サンプルは 2 つです：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 のライセンス検証ミドルウェア。キーを販売し、サーバーで検証します
• 📊 使用量の計測とキーごとのレート制限 — 無料プラン／有料プランをすぐに利用できます
• 🌐 Streamable 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 がリリースされたら、固定バージョンを更新してテストを再実行してください。厳密に固定しているのは、上流のベータ版の変更によってビルドが気付かないうちに壊れるのを防ぐためです。