0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

MCP SDKのnpmを確認したら、ステートレス仕様の確定日に9パッケージへ分裂していた

0
Last updated at Posted at 2026-07-28

はじめに

Model Context Protocol(MCP)の公式ブログが、2026-07-28に仕様の大規模改定(通称「ステートレス化」)を正式リリースしたと発表しました。対象読者は、MCPサーバーやMCPクライアントをTypeScriptで開発している、またはこれから開発しようとしているエンジニアです。

「仕様が変わったなら、まず公式SDKがどうなったか見てみよう」と思い、npm で実際に @modelcontextprotocol/sdk を確認したところ、想定と違う光景に出会いました。本記事はその場で実際に実行したコマンドと出力をもとに書いています。

この記事で分かること

  • MCP 2026-07-28仕様(ステートレス化)が何を変えたのか(公式情報の要約)
  • 公式TypeScript SDKの中身を実際に取得して検証した結果
  • 既存プロジェクトが今日時点でどう影響を受けるか

背景: MCPがステートレスになった

MCP公式ブログによると、2026-07-28仕様の最大の変更は「セッション概念の廃止」です。

The base protocol is going stateless — no more Mcp-Session-Id, no more initialize handshake, every request stands on its own.
出典: The 2026-07-28 MCP Specification Release Candidate(Model Context Protocol公式ブログ)

同ブログによれば、リリース候補(RC)は2026年5月21日に公開され、SDK開発者・クライアント実装者が実運用のワークロードで検証できるよう 10週間の検証ウィンドウ が設けられていました。この検証ウィンドウが明けたのが本日2026-07-28です。あわせて、機能の非推奨化には最低12ヶ月の告知期間を義務付ける新しいライフサイクルポリシー(Active → Deprecated → Removed)も導入されています。

主な変更点は次のとおりです。

項目 旧仕様(2025-11-25) 新仕様(2026-07-28)
セッション管理 initialize ハンドシェイク+ Mcp-Session-Id ヘッダ必須 ハンドシェイク廃止。セッションは必要な場合のみ opt-in
ルーティング リクエストボディの中身を見ないと種別が分からない Mcp-Method / Mcp-Name ヘッダで判別可能
ツール一覧のキャッシュ 明示的なTTLなし tools/list レスポンスに ttlMs を追加
スケーリング セッションアフィニティ・共有セッションストアが必要 素のラウンドロビン ロードバランサだけで水平スケール可能

(出典: Model Context Protocol公式ブログ)

ここまでは公式ブログの要約(二次情報)です。ここから先は、実際に手を動かして確認した内容になります。

実際に検証してみたこと

ステップ1: 公式TypeScript SDKの最新版を確認する

まず、もっとも広く使われている公式パッケージ @modelcontextprotocol/sdk の状態を確認しました。

$ npm view @modelcontextprotocol/sdk version
1.30.0

$ npm view @modelcontextprotocol/sdk time --json | tail -3
  "1.29.0": "2026-03-30T16:50:42.718Z",
  "1.30.0": "2026-07-27T17:56:01.640Z"

time フィールドはUTCで返ってくるため、JST(UTC+9)に変換すると 2026-07-28 02:56 です。つまり最新版の 1.30.0 は、仕様確定と同じ2026-07-28の未明に公開されていました。「仕様確定に合わせて公式SDKも更新されたのだろう」と考え、実体を取得して中身を見てみました。

$ npm pack @modelcontextprotocol/sdk@1.30.0
$ tar xzf modelcontextprotocol-sdk-1.30.0.tgz
$ grep -n "LATEST_PROTOCOL_VERSION\s*=" package/dist/cjs/types.js
33:exports.LATEST_PROTOCOL_VERSION = '2025-11-25';

結果は 2025-11-25。つまり 仕様確定当日の未明(02:56 JST)に公開された最新版でも、SDKが認識するプロトコルバージョンは1世代前のまま でした。念のため、新仕様の目玉である ttlMs(キャッシュTTL)・Mcp-Method ヘッダ・server/discover メソッドの実装有無も grep しましたが、いずれも該当箇所はゼロでした。

ステップ2: 「本当にSDKは追従していないのか」を裏取りする

ここで一度立ち止まり、GitHub の Releases ページも確認しました。すると @modelcontextprotocol/sdk とは 別に、以下の9つの新しいパッケージが目に入りました。

@modelcontextprotocol/server@2.0.0
@modelcontextprotocol/server-legacy@2.0.0
@modelcontextprotocol/node@2.0.0
@modelcontextprotocol/hono@2.0.0
@modelcontextprotocol/fastify@2.0.0
@modelcontextprotocol/express@2.0.0
@modelcontextprotocol/core@2.0.0
@modelcontextprotocol/codemod@2.0.0
@modelcontextprotocol/client@2.0.0

npm view <pkg> time --json でバージョン 2.0.0 の公開時刻を1つずつ確認し、UTCからJSTへ変換したところ、すべて 2026-07-28 08:55頃(JST) に公開されていました。つまり @modelcontextprotocol/sdk 1.30.0(同日02:56 JST公開)から約6時間後、公式は既存パッケージを更新する形ではなく、新しいパッケージ群を新規に切り出す形 で仕様改定に対応していたことになります。

ステップ3: 新パッケージの中身を検証する

@modelcontextprotocol/core / server / client の3つを npm pack で取得し、展開して確認しました。

$ npm pack @modelcontextprotocol/core@2.0.0 @modelcontextprotocol/server@2.0.0 @modelcontextprotocol/client@2.0.0
$ grep -rn 'LATEST_PROTOCOL_VERSION' extract-core/package/dist/*.cjs | grep -v map
extract-core/package/dist/auth-CfDMXiII.cjs:32:const LATEST_PROTOCOL_VERSION = "2025-11-25";

意外なことに、新パッケージの LATEST_PROTOCOL_VERSION 定数も 2025-11-25 のままでした。ただし、旧SDKには存在しなかった PROTOCOL_VERSION_META_KEY(io.modelcontextprotocol/protocolVersion)・CLIENT_INFO_META_KEY・SERVER_INFO_META_KEY という、2026-07-28仕様の _meta フィールド用の新定数がコード中に追加されていることを確認しました。さらに server / client パッケージの実体には、新仕様の主要機能が実際に実装されていました。

$ grep -o '"mcp-method"' extract-server/package/dist/index.mjs
"mcp-method"
$ grep -o 'ttlMs' extract-client/package/dist/index.mjs
ttlMs

つまり、プロトコルバージョン定数の更新は追いついていないものの、Mcp-Method ヘッダや ttlMs といった新仕様の中身は新パッケージにすでに実装されている ことが確認できました。旧来の @modelcontextprotocol/sdk にはいずれも存在しません。

分かったこと(比較表)

@modelcontextprotocol/sdk(旧・単体パッケージ) @modelcontextprotocol/core 等(新・9パッケージ)
最新バージョン 1.30.0 2.0.0
公開日時(JST) 2026-07-28 02:56 2026-07-28 08:55頃
LATEST_PROTOCOL_VERSION 2025-11-25 2025-11-25(定数は据え置き)
Mcp-Method ヘッダ実装 なし あり(server パッケージ)
ttlMs 実装 なし あり(client パッケージ)
Node.js 要件 >=18 >=20
README上の移行案内 確認できず -

筆者が実際に確認した限り、@modelcontextprotocol/sdk のREADMEやnpmの deprecated フラグには、この時点(2026-07-28昼)で新パッケージ群への移行案内は見当たりませんでした(npm view @modelcontextprotocol/sdk deprecated は空でした)。

著者視点の発見ポイント

筆者が実際に検証して気づいたのは、公開時刻をJSTに変換して初めて見えてきた 同じ2026-07-28という1日の中での約6時間差 です。当初は「前日リリースのSDKが仕様改定に追従していない」という後ろ向きなギャップを想定していましたが、実際にはUTC表記をそのまま読んでいただけで、変換すると @modelcontextprotocol/sdk 1.30.0(02:56 JST)も9パッケージ群(08:55頃 JST)も 仕様確定当日の同じ朝 に公開されていました。旧SDKが先に更新され、その約6時間後に新パッケージ群へ切り出されたという時系列が分かり、単なる更新の遅れではなく、アーキテクチャレベルの再設計が同日中に段階的に進行していた ことが見えてきました。

実務上のポイントは次の3つです。

  1. 既存プロジェクトは今日時点で壊れない: @modelcontextprotocol/sdk に依存している既存のMCPサーバー/クライアントは、今回の仕様確定によって突然動かなくなることはありません(SDK自体が旧仕様のまま維持されているため)。
  2. 新規に始めるなら Node.js のバージョンに注意: 新パッケージ群は engines.node が >=20 に上がっており、旧SDKの >=18 からNode.jsのバージョン要件が上がっています。新パッケージへ乗り換える場合は、まずランタイムの対応状況を確認する必要があります。
  3. 移行時期は急がず、リリースノートを継続的に確認する: 公式ブログが示す10週間の検証ウィンドウと12ヶ月の非推奨ポリシーを踏まえると、既存パッケージがすぐに廃止される設計ではなさそうです。ただし新パッケージ側の README に移行ガイドがまだ整備されていないため、しばらくは npm view @modelcontextprotocol/sdk deprecated や GitHub Releases を定点観測するのが安全です。

まとめ

  • MCP 2026-07-28仕様は「セッション廃止・Mcp-Method ヘッダ・ttlMs キャッシュ」を軸にしたステートレス化の正式リリースでした(公式ブログより)。
  • 実際に npm view / npm pack で公式TypeScript SDKを確認したところ、既存の @modelcontextprotocol/sdk(1.30.0・仕様確定日の02:56 JSTにリリース)は旧仕様のプロトコルバージョンのままでした。
  • その約6時間後(08:55頃 JST)に @modelcontextprotocol/core / server / client など9つの新パッケージが公開されており、こちらには Mcp-Method ヘッダや ttlMs が実装済みでした。
  • 既存プロジェクトへの影響は今日時点ではありませんが、新規プロジェクトはNode.jsバージョン要件の違いを踏まえて移行を検討する必要があります。

関連記事

参考リンク

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?