MCPとは?

Model Context Protocol (MCP)はAnthropicによるオープンスタンダードです。AIアシスタントを外部データソースやツールに接続します。AIのためのUSB-Cのようなものです。

重要な理由

MCP以前はすべてのAI統合がカスタムでした。MCPがこれを標準化します。

アーキテクチャ

  • MCPホスト: AIアプリケーションです(例: Claude Desktop、Cursor)。
  • MCPサーバー: プロトコル経由でツールとリソースを公開します。
  • MCPクライアント: ホストとサーバーを接続します。

主要概念

  • ツール: AIが呼び出せる関数です(検索、ファイル作成、データベースクエリ)。
  • リソース: AIが読めるデータです(ファイル、データベースレコード、APIレスポンス)。
  • プロンプト: アプリケーション間で共有される再利用可能なプロンプトテンプレートです。

MCPサーバーの構築

1. JSONスキーマでツールを定義します。

2. MCPプロトコルを実装します(RESTまたはstdioトランスポート)。

3. ケイパビリティ(ツール、リソース、プロンプト)を登録します。

4. MCP InspectorまたはClaude Desktopでテストします。

エコシステム

  • GitHub: リポジトリとイシュー向けのMCPサーバーです。
  • PostgreSQL: データベースクエリ向けのMCPサーバーです。
  • Slack: メッセージングとチャンネル向けのMCPサーバーです。
  • ファイルシステム: ローカルファイルアクセス向けのMCPサーバーです。

開発者向け

  • MCP SDKはTypeScriptとPythonで利用できます。
  • modelcontextprotocol.ioの仕様に従ってください。
  • コミュニティのサーバーは急速に増えており、数百が利用可能です。

最初のMCPサーバー構築

TypeScript SDKの最小例:サーバー定義、ツール登録、リクエスト処理です。

旧APIは残っていますが非推奨のため、現行の入口を使います:

  • `npm install @modelcontextprotocol/sdk zod`
  • `import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";`
  • `import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";`
  • `const server = new McpServer({ name: "my-tool", version: "1.0.0" });`
  • `server.registerTool("search", { inputSchema: { query: z.string() } }, async ({ query }) => ({ content: [{ type: "text", text: JSON.stringify(await searchDatabase(query)) }] }));`
  • `await server.connect(new StdioServerTransport());`

出典: npm の @modelcontextprotocol/sdk パッケージ、バージョン 1.32.2、2026-11-10 確認。以前の本文が参照していた @mcp/sdk は npm に存在しません。

セキュリティ考慮

  • 認証: APIキーまたはOAuthトークンを要求します。
  • 入力検証: スキーマに対し全入力を検証してください。
  • レート制限: 1クライアント100リクエスト/分です。
  • 監査ログ: 全ツール呼び出しを記録します。

MCP vs 従来のAPI

MCPはセマンティック理解を追加します。AIが各ツールの機能と使用タイミングを認識します。コンテキストに基づき呼び出すツールをAIが決定します。エージェントワークフローに最適です。

統合面はツールスキーマそのもの

MCPを評価するとき、人はたいていトランスポートを比較し、他のシステムが依存する部分がツール定義、つまり名前、説明、引数と結果の形であることを忘れます。説明が曖昧なツールはすべてのクライアントから誤ったタイミングで呼ばれ、非構造化の散文を返す結果は下流の何とも組み合わせられません。労力をスキーマと説明に注いでください。トランスポートは解決済みの問題で、インターフェースはそうではありません。

説明はプロンプトです。モデルがそもそもこのツールを呼ぶべきかを判断するために書き、いつ呼ぶべきでないかも含めます。引数の命名を明確にするのは省略よりずっと重要で、小さな型付きオブジェクトを返す結果は毎回一段落のテキストに勝ります。

ローカルサーバーは摩擦の少ない出発点

ユーザー自身の機械で動くstdioサーバーは、最も難しい問題を一度に避けます。ホスティング不要、認証基盤不要、そしてプロセスがユーザーの権限とユーザーのデータで動くため自然な信頼境界があります。そこから始めてください。能力が本当にマシンやユーザーをまたいで共有される必要があるときにだけリモートHTTPサーバーへ移り、そうすれば認証、認可、マルチテナンシーを自分で負うことを受け入れます。

統合が実際に壊れる場所

stdoutに書き込むサーバー。stdioではstdoutがプロトコルチャネルなので、余計なprintがストリームを壊し、失敗はクライアントのバグに見えます。ログはstderrへ、そしてサーバーを起動してJSONでないバイトがないか見るテストをします。その一つの確認が何時間もの混乱するデバッグを省きます。

妥当な最初のサーバー

既存の社内ツールを1つ包み、正確なスキーマと正直な説明で公開し、他人に配る前に自分で1週間使ってください。