MCP Starter Project

MCP Server Starter

独自の MCP サーバーを構築したいですか？

MCP Server Starter は、MCP 標準を使用して Cursor、Claude などでローカルツールを実行するための基本的な構成を提供します。

---

機能

• 📡 柔軟な通信

  • クライアントとサーバー間の複数の通信プロトコルに対応しています。
  • stdio：ローカルでの使用
  • Streamable HTTP：リモートおよびローカルでの使用
  • sse：リモートおよびローカルでの使用（非推奨）~~

• 📦 最小限のセットアップ - 基本的なサーバー実装ですぐに始められます。

• 🤖 Cursor AI との統合 - .cursor/mcp.json の設定例が含まれています。

• ⌨️ TypeScript - プロジェクトに型安全性を追加します。

今後の予定

• 独自のパッケージを公開するオプションを追加
• スキャフォールディングの CLI サポートを改善
• ツールをその場で構築するためのプロンプト

はじめに

前提条件

• Node.js（必要に応じてバージョンを指定してください）
• MCP 互換のクライアント（例：Cursor）

使用方法

対応するトランスポートオプション

Model Context Protocol は複数のトランスポート方式に対応しています。

stdio

ローカル環境での使用を推奨します

コードエディターのサポート

以下のコードスニペットを追加してください

• Cursor：.cursor/mcp.json

ローカル開発／テスト

MCP サーバーをローカルでテストする場合に使用してください

{
  "mcpServers": {
    "my-starter-mcp-stdio": {
      "command": "node",
      "args": ["./bin/cli.mjs", "--stdio"]
    }
  }
}

公開済みパッケージ

npm レジストリにパッケージを公開済みの場合に使用してください

{
  "mcpServers": {
    "my-starter-mcp-stdio": {
      "command": "npx",
      "args": ["my-mcp-server", "--stdio"]
    }
  }
}

Streamable HTTP

重要：Streamable HTTP はまだ Cursor でサポートされていません

リモートサーバーでの使用を推奨します

重要： stdio とは異なり、適切なフラグを付けてサーバーを実行する必要があります

ローカル開発 streamable http トランスポートを使用します

1. MCP サーバーを起動します ターミナルで次を実行してください

node ./bin/cli.mjs --http --port 4200

または、mcp inspector を使用します

npm run dev-http
# npm run dev-sse (deprecated)

2. これを設定に追加します

{
  "mcpServers": {
    "my-starter-mcp-http": {
      "command": "node",
      "args": ["./bin/cli.mjs", "--http", "--port", "4001"]
      // "args": ["./bin/cli.mjs", "--sse", "--port", "4002"] (or deprecated sse usage)
    }
  }
}

公開済みパッケージ

npm レジストリにパッケージを公開済みの場合に使用してください

ターミナルで次を実行してください

npx my-mcp-server --http --port 4200
# npx my-mcp-server --sse --port 4201 (deprecated)

{
  "mcpServers": {
    "my-starter-mcp-http": {
      "url": "http://localhost:4200/mcp"
      // "url": "http://localhost:4201/sse"
    }
  }
}

Inspector を使用する

inspect コマンドを使用して MCP サーバーをデバッグします

コマンドラインオプション

プロトコルの選択

プロトコル	説明	フラグ	備考
stdio	標準入出力	(なし)	デフォルト
http	HTTP REST	--port <num> (既定値：3000), --endpoint <path> (既定値：/mcp)
sse	サーバー送信イベント	--port <num> (既定値：3000)	非推奨

ライセンス

このプロジェクトは MIT ライセンスのもとで公開されています。詳細は LICENSE ファイルをご覧ください。

---

講座

• AI を活用したソフトウェア開発を学ぶ：instructa.ai