MCP Ts Quickstart

🚀 MCP プロトコルクイックスタートガイド（TypeScript 版）

これは、TypeScript を使用した MCP のクイックスタートサンプルです。

stdio 転送プロトコルに基づく基本的な MCP サーバーの実装を含み、Hacker News からトップストーリーを取得します。

この実装にはビルド手順が必要なく、Node.js v23 で直接実行できます。

MCP 公式ドキュメント に提供されているサンプルに基づいています。

🚀 クイックスタート

📦 インストール

以下のコードスニペットを実行するには、git、nvm、pnpm が必要です。

git clone git@github.com:cephalization/mcp-ts-quickstart.git
cd mcp-ts-quickstart
nvm install && nvm use
pnpm install

💻 使用例

クローンして依存関係をインストールした後、このサーバーを Claude Desktop に追加できます。設定ファイルは次のようになります。

{
  "mcpServers": {
    "hacker-news": {
      "command": "/Users/tony/.nvm/versions/node/v23.6.0/bin/node",
      "args": ["/Users/tony/repos/mcp/src/index.ts"]
    }
  }
}

Claude Desktop の使用方法の詳細については、MCP 公式ドキュメント を参照してください。

🔧 開発

以下のコマンドを実行すると、依存関係をインストールしてから MCP サーバーを起動し、MCP Inspector UI をクライアントとして使用できます。

nvm install && nvm use
pnpm install
pnpm start

サーバーにはビルド手順がないため、インスペクター UI で「再起動」ボタンをクリックすることでサーバーを再起動できます。

🌱 サーバーの拡張

サーバーの実装は src/index.ts ファイルにあります。 トップストーリーツールの実装は src/tools.ts ファイルにあります。 新しいツールを追加するには、トップストーリーツールをコピーして変更してください。 ローカルソースファイルをインポートする際には、Node が正しく解決できるように .ts 拡張子を使用するようにしてください。 型をインポートする際には、Node ランタイムがそれを削除できるように type キーワードを先頭に付けるようにしてください。 ライブラリをインポートする際には、ライブラリがエクスポートマッピングを提供しない場合は、実際のファイル拡張子をインポートするようにしてください。

🕵️‍♂️ MCP Inspector

MCP Inspector は、MCP サーバーとやり取りするための UI です。 起動後、http://localhost:6274 で利用できます。