create-mcp-ts

create-mcp-ts

TypeScript で MCP サーバーを作成します。必要なものがすべて含まれています。

はじめに

npm init mcp-ts your-server
cd your-server
npm run dev

create-mcp-ts では、ビルド設定は一切不要です。MCP サーバーの開発、ビルド、セットアップに必要なものがすべて自動的にインストールされます。

Cursor、Windsurf、Claude Desktop で MCP サーバーをセットアップする

create-mcp-ts は、Cursor、Windsurf、Claude Desktop で MCP サーバーを自動的に設定できます。

npm run setup

このスクリプトは、各クライアントの MCP 設定ファイルに your-server がすでに存在するかどうかを確認します。存在しない場合は、サーバースクリプト（dist/index.js）を指すエントリーを追加します。

{
  "mcpConfig": {
    "your-server": {
      "command": "node",
      "args": ["/path/to/your-server/dist/index.js"]
    }
  }
}

Cursor、Windsurf、Claude Desktop での MCP サーバーのセットアップ方法について詳しくは、以下をご覧ください。

• Cursor の MCP ドキュメント
• Windsurf の MCP ドキュメント
• Claude Desktop の MCP ドキュメント

カスタムテンプレート

カスタムテンプレートを使用するには、テンプレートの npm パッケージ名またはファイルパスを npx create-mcp-ts コマンドに渡します。

npx create-mcp-ts your-server --template=mcp-ts-template-default
npx create-mcp-ts your-server --template=file:/path/to/mcp-ts-template

MCP サーバーを公開する

MCP サーバーを共有する場合は、npm に公開できます。

1. package.json の "version" を設定し、"private" が false に設定されていることを確認します。
2. npm install を実行します。
3. npm run build を実行します。
4. 必要に応じて npm login を実行します。
5. npm publish を実行します。

mcp-scripts からの移行

mcp-scripts パッケージには、create-mcp-ts プロジェクト用のビルドツールが含まれており、追加の設定なしで MCP サーバーの開発、ビルド、セットアップに必要なすべてを提供します。

内部では、mcp-scripts は tsup と esbuild を使用しています。これらは軽量で、実績があり、本番環境向けの TypeScript プロジェクトに適したユーティリティです。

mcp-scripts から移行する場合は、次のコマンドを実行します。

npm run eject

これにより、mcp-scripts の依存関係が削除され、プロジェクトの package.json ファイル内の関連コマンドが置き換えられます。

MCP サーバーのトラブルシューティング

Node.js がインストールされていることを確認する

MCP サーバーの実行時に問題が発生した場合、まず Node.js がグローバルにインストールされていることを確認してください。次のコマンドを実行すると確認できます。

node --version

Node.js がインストールされていない場合は、こちらの手順に従ってインストールできます。

Node.js バージョンマネージャーを使用する場合

一部の MCP クライアント環境では、システムの PATH 全体にアクセスできないことがあり、nodenv や nvm などの Node.js バージョンマネージャーを使用する際に問題が発生する場合があります。その場合は、MCP 設定で Node.js バイナリのフルパスを指定する必要があります。

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

Node.js バイナリの絶対パスを確認するには、次のコマンドを実行します。

which node

各クライアント（Cursor、Windsurf、または Claude Desktop）の MCP 設定を更新し、使用する Node.js バイナリの正しい絶対パスを指定してください。

その他の問題については、こちらから issue を作成してください。

方針

create-mcp-ts は、MCP サーバー開発者向けに、必要なものがすべて揃った「使うだけですぐ動く」体験を提供するよう設計されています。

• 必要なものがすべて揃っています：ビルド依存関係は mcp-scripts のみです。tsup、esbuild、その他の優れたオープンソースプロジェクトを使用しつつ、それらを基盤に厳選された体験を提供します。
• 設定不要：何も設定する必要はありません。適切な設定はすべて用意されるため、コードの作成に集中できます。
• ロックインなし：いつでもカスタム設定に「移行」できます。コマンドを1つ実行するだけで、すべての設定とビルド依存関係がプロジェクトに直接移されるため、そのまま作業を続けられます。

このプロジェクトは create-react-app に着想を得ています。

関連パッケージ

• packages/mcp-scripts：create-mcp-tsプロジェクトを支えるビルドツールです。
• packages/mcp-ts-template-default：create-mcp-tsのデフォルトのプロジェクトテンプレートです。