modelcontextprotocol/typescript-sdk

Model Context Protocol (MCP) TypeScript SDK – 速報

何であるか – Model Context Protocol (MCP) サーバーとクライアントを構築できる TypeScript ライブラリのセットです。MCP は、大規模言語モデルに構造化されたコンテキスト（ツール、リソース、プロンプトなど）を供給するための軽量で言語非依存の仕様です。この SDK は 2026 年 7 月版の仕様を実装しており、Node.js、Bun、Deno で動作します。

主要パッケージ

• @modelcontextprotocol/server – ツールやリソースを定義し、HTTP、stdio、またはその他のトランスポート経由で公開するためのヘルパー。
• @modelcontextprotocol/client – サーバーの機能を検出し、ツールを呼び出すためのユーティリティ。
• オプションのミドルウェアアダプター（@modelcontextprotocol/express、fastify、hono、node）は、MCP を人気のあるウェブフレームワークに簡単に統合できるようにします。

使い方

1. サーバーの作成 – McpServer をインスタンス化し、Zod（または互換性のある）スキーマでツールを登録し、トランスポート（例：StdioServerTransport）をアタッチします。
2. クライアントの作成 – クライアントパッケージを使ってサーバーに接続し、利用可能なツールを一覧表示して呼び出します。
3. デプロイ – トランジスタパッケージを介して、HTTP ランタイムにサーバーを接続します。

重要性 – LLM 呼び出しとは別に「コンテキストの提供」を分離することで、MCP は同じツール定義を異なるモデル、クラウドプロバイダー、またはオフデバイスランタイムで再利用できるようにします。この SDK は、独自のプロトコル処理を実装せずに、タイプセーフで即時利用可能な方法で仕様を採用できるようにします。

ドキュメントとサポート – 完全なガイド、APIリファレンス、移行ノートは https://ts.sdk.modelcontextprotocol.io/v2/ で公開されています。GitHub で問題を報告できます。プロジェクトは Apache-2.0（新規コード） / MIT（レガシー）です。

---

TL;DR

• 目的: LLM に構造化されたコンテキストを供給する MCP準拠サービスの構築と利用。
• 言語: TypeScript（Node、Bun、Deno）。
• コアライブラリ: @modelcontextprotocol/server と @modelcontextprotocol/client。
• 付加機能: Express、Fastify、Hono、プレーン Node HTTP 用の軽量アダプター。
• 開始方法: npm i @modelcontextprotocol/server @modelcontextprotocol/client を実行し、その後「最初のサーバー/クライアント」チュートリアルに従ってください。