MCP TS Quickstart

MCP TS クイックスタート

TypeScript で MCP を使うためのクイックスタートです。

stdio トランスポートを使用する基本的な MCP サーバーの実装が含まれており、Hacker News のトップストーリーを取得します。

Node v23 を利用することで、ビルド手順なしで動作するよう TypeScript で記述されています。

MCP のドキュメントにある例を基にしています。

使用方法

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

git clone [email protected]: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 Inspector の UI を使って MCP サーバーが起動します。

nvm install && nvm use
pnpm install
pnpm start

このサーバーはビルド不要のため、Inspector の UI で「Restart」ボタンを押すだけで、サーバーを「再起動」できます。

サーバーの拡張

サーバーは src/index.ts に実装されています。

topStories ツールは src/tools.ts に実装されています。

新しいツールを追加するには、topStories ツールをコピーして変更します。

ローカルの src ファイルをインポートするときは、node が解決できるように .ts 拡張子を使用してください。

型をインポートするときは、実行時に node が削除できるよう、インポートの前に type キーワードを付けてください。

ライブラリをインポートするときは、exports マッピングが提供されていない場合、実際のソースファイル拡張子を指定してください。

MCP Inspector

MCP Inspector は、MCP サーバーとやり取りするための UI です。

起動すると、http://localhost:6274 で利用できます。