MCP Client SDK概要｜TypeScriptとPythonで始める

既存のMCP Serverはある。CursorやClaude Desktopに足すのではなく、自分のアプリからToolを一覧し、1回呼び出したい。そのとき検索結果には、Serverの自作手順、製品アプリの設定画面、公式のチャットボット例が同じキーワードで並びやすく、「何を最初に実装し、どこまで見れば動いたか」が切れにくいです。

本記事では、公式のBuild an MCP clientとSDKsに沿い、自前Client（自分のアプリ側の接続プログラム）を公式SDKで書くときの手順を整理します。手順の骨格はTypeScript中心です。Pythonは対応関係の短表と公式節への案内までにとどめます。

製品アプリの設定場所の探し方や、Server側のregisterToolの実装手順は扱いません。

今日の結論

• 自前Clientは公式SDKのClientと接続の運び方（transport）が中心です。手順の骨格はTypeScript（@modelcontextprotocol/client＋StdioClientTransport）です。
• 最初に揃えるのは「Serverに接続できる」「Tool一覧が取れる」「1回呼べる」の3つです。LLMチャットボットの全文ループは必須にしません。
• Cursor／Claudeなど既存アプリへの足し方は、製品ごとの設定記事側です。この記事の対象ではありません。
• Pythonにも接続・一覧・1呼び出しに対応するAPIがあり、詳細手順は公式のBuild-clientのPython節へ送ります。
• Server自作・運び方の比較・権限の監査は、この記事では扱いません。必要になったときは各手順の記事や公式ドキュメントを参照してください。

自前Clientと製品Clientの違い、公式SDKの選び方

自前か製品かを先に分けると、読むドキュメントがぶれません。

この記事が扱うのは上段だけです。製品アプリの設定キーや画面の操作は、Cursor／Claude Desktop／Claude Code／VS Codeに任せます。

公式のSDKsでは、TypeScriptとPythonがいずれもTier 1として案内されています。本記事はこの2言語に限定します。C#やGoなど他言語の手順は扱いません。

Host／Client／Serverの役割そのものを一から説明する必要が出たら、MCPの仕組みを参照してください。ここでは「自前ClientはServerに接続する側」という線引きだけで進めます。

TypeScriptで接続する最小の流れ

公式のTypeScript節では、執筆時点で確認した内容ではNode.js 20以上とnpmを前提にしています。パッケージは@modelcontextprotocol/clientです。インストール例は次のとおりです（チャットボット連携用のAnthropic SDKは、接続・一覧・1呼び出しの確認には不要です）

npm init -y
npm install @modelcontextprotocol/client
npm install -D @types/node typescript

package.jsonには"type": "module"を指定します。tsconfig.jsonの細部は公式Build-clientのTypeScript節に合わせてください。

接続の中心は次の2つです。

• Client: Serverと話し、Toolの一覧取得や呼び出しを行うオブジェクト
• StdioClientTransport: ローカルでServerプロセスを起動し、標準入出力でつなぐ接続の運び方

公式チュートリアルでは、Serverスクリプトのパスを引数に取り、拡張子が.jsならNode、.pyならPythonで起動する、という読み方になっています。自分のServerの起動コマンドが決まっているなら、commandとargsをその起動に合わせて渡します。

import { Client } from "@modelcontextprotocol/client";
import { StdioClientTransport } from "@modelcontextprotocol/client/stdio";

const transport = new StdioClientTransport({
  command: "node",
  args: ["/ABSOLUTE/PATH/TO/server.js"],
});

const client = new Client({ name: "sample-client", version: "1.0.0" });
await client.connect(transport);

パスやコマンドはプレースホルダです。手元のServerの起動方法に置き換えてください。認証情報が必要なServerでは、環境変数や設定ファイルに置き、コードへ直書きしないでください。

この骨格は「つながったか」を確認するための最小例です。HTTP／SSEでの本番接続や、チャット画面の実装は扱いません。運び方の比較が必要になったらstdioとHTTP/SSEの違いへ進んでください。

Tool一覧と1呼び出しまで確認する

接続できたあとは、一覧取得と1回の呼び出しを分けて確認します。公式のTypeScript例では、接続直後にlistTools()で名前を取り、必要になったときにcallTool()で呼びます。

const toolsResult = await client.listTools();
console.log(toolsResult.tools.map((tool) => tool.name));

const result = await client.callTool({
  name: "say-hello",
  arguments: { name: "world" },
});
console.log(result);

await client.close();

say-helloは例です。実際のTool名・引数の形は、一覧で得た定義とServer側の仕様に合わせてください。機密情報を含む入力は使わないでください。

確認の切り分けは次の3段です。

1. つながったか: connectが例外なく終わるか。終わらない場合は起動コマンド・パス・Server側の待ち受けを先に疑います。
2. 一覧が取れるか: listTools()の結果に期待するTool名が出るか。出ない場合は、接続先のServerが想定と違う／Server側でToolが未登録、の線を見ます。
3. 1回呼べるか: 引数の形が合っているか。名前は合っていても入力スキーマが違うと失敗します。

失敗したときに「全部壊れている」と一括りにせず、上のどこで止まったかを切り分けると戻りやすいです。権限やトークンの監査まで広げたくなったら権限とセキュリティへ。Server側の公開手順そのものを直す必要があるならServerの作り方入門へ進んでください。

公式Build-clientのチャットボット例は、一覧と呼び出しのあとにAnthropic Messagesで会話ループを回します。LLM連携は公式例として存在しますが、自前Clientの最初の確認（接続・一覧・1呼び出し）には含めません。

Python側の対応関係

Pythonでも同じ確認（接続・一覧・1呼び出し）を公式が案内しています。パッケージはPyPIのmcpです。執筆時点で確認した公式例では、Client、StdioServerParameters、stdio_client、list_tools、call_toolが中心です。

環境構築にuvを使う手順や、Anthropic APIキーを.envへ置く手順は、公式Build-clientのPython節にあります。操作画面のツアーはここでは書きません。Pythonで全文を追いたい場合は、TypeScript側で接続→一覧→1呼び出しの意味が分かったあとに読むと迷いにくいです。

止まったときの確認先

症状に近いものから確認すると早く進みます。原因を1つに決めつけず、当てはまる項目を見てください。

まとめ

自前アプリから既存のMCP Serverを呼ぶとき、最初に揃えるのは公式Client SDKのClientとtransportです。TypeScriptなら@modelcontextprotocol/clientとStdioClientTransportでつなぎ、一覧と1呼び出しまで取れれば、最初の確認としては十分です。

製品アプリへの設定、Serverの自作、運び方の比較、権限の設計まで手を広げたくなったら、MCP Hubから関連する手順を探してみてください。

本記事の内容は執筆時点（2026-09-21）の情報に基づきます。公式ドキュメントを参照しており、掲載手順の実機での動作は未検証です。SDKのパッケージ名・API・起動コマンドは変更される可能性があります。ビルドの成功や本番利用の適否を保証するものではありません。重要な判断は公式ドキュメントで確認してください。