workshop-27-08-26

2026年8月27日のブートキャンプ AWS AI FDE for Commerce のワークショップ用MCPサーバーの例

MCPとは？

MCP (Model Context Protocol) は、システム間の通信のための オープンソース プロトコルであり、異なるアプリケーション（主にAI）間でのデータ/コンテキスト情報の交換を可能にします。

このプロトコルを使用すると、AIシステム（エージェントアプリケーションなど）が別のシステムからコンテキスト情報を消費/提供できるようになり、モデルがより確実かつ関連性の高い動作をすることが可能になります。

USB-Cのアナロジー を使用すると：

MCPをAIアプリケーションのUSB-Cポートと考えてください。USB-Cが電子デバイスを接続する標準的な方法を提供するように、MCPはAIアプリケーションを他のシステムに接続する標準的な方法を提供します。

Related MCP server: Basic MCP Server

SDKのオプション

このプロトコルは、さまざまな言語/フレームワークでMCPを実装するために使用できる、さまざまなSDK（ソフトウェア開発キット）のオプションをサポートしています。

完全なリストはこちら: 利用可能なSDK

トランスポートのオプション

ワークショップの文脈に焦点を当てて、Node.jsで最も一般的/人気のあるトランスポートオプションを探ってみましょう：

stdio

MCPサーバーを子プロセスとして実行し、stdin と stdout を介してメッセージを送受信します。

stdioで提供する

HTTP

HTTPリクエストを介して複数のクライアントに同時にメッセージを送受信するサーバーを提供します。

HTTPで提供する

Frameworks

MCPプロトコルの実装を容易にするために、Node.jsのテクノロジー/フレームワークを使用します。例：

• Express

• Fastify

• Hono

ワークショップのシナリオ

クライアント Nordesul

1. 大手クライアントのeコマースプロジェクトを考えてみましょう。20人の開発者チームが、レガシーな仮想ストア（V0）をよりモダンなフレームワーク（V1）に移行するために割り当てられています。目標は、仮想ストア V1 が V0 と同一でありながら、V1 のパフォーマンス改善を利用することです。

2. 複数の開発者が同じコードベースで作業するため、納品物が可能な限り最高の標準化と品質を持ち、当社の規範とアイデンティティに従うことが不可欠です。

3. クライアントは、すべてのAPIのドキュメントを含むデータベースを持っており、それらは開発チームと共有されたエンドポイントにあり、参照することができます。

このリポジトリ

このリポジトリにはMCPサーバーのテンプレートが含まれており、以下の目的に使用できます：

• @modelcontextprotocol/server を使用した stdio および HTTP トランスポートの実装を理解する；

• AIシステムと任意の外部サービス間の通信をシミュレートする；

• 実際のMCPサーバーの実装のインスピレーションとして役立てる；

• カスタム tools を使用したAIエージェントの使用への入り口となる。

リポジトリの構造

/servers

さまざまなトランスポートとフレームワークを使用したサンプルMCPサーバー。

• /servers/stdio

子プロセスとして、stdin と stdout を介してMCPメッセージを提供します。

• /servers/http

Node.jsのネイティブHTTPモジュールのみを使用して、HTTPリクエストを介してMCPメッセージを提供します。

• /servers/express

Expressフレームワークを使用して、HTTPリクエストを介してMCPメッセージを提供します。

/tools

AIエージェントが他のシステムと対話するために使用できるカスタム tools の例。

• /tools/index.js

リポジトリ内のすべての tools を一元化してエクスポートし、MCPサーバーがそれらを統一的に登録できるようにします。

• /tools/nordesul-deploy

Nordesulクライアントでの安全なデプロイに不可欠な注意点とベストプラクティスを返します。

• /tools/nordesul-delivery

プロジェクトの実装パターンと契約をシミュレートします。

• /tools/nordesul-reference

NordesulクライアントでのAPIドキュメントの参照をシミュレートします。

• /tools/nordesul-status

Nordesulクライアントでのアプリケーションのステータス参照をシミュレートします。

/utils

プロジェクトのユーティリティ/共有関数を一元化します。

/.opencode

Opencodeの設定ディレクトリで、ワークショップの参加者がリポジトリとその機能を理解するのを支援するカスタムエージェント mentor が含まれています。

プロジェクトの実行

前提条件

• Git；

• ワークショップのリポジトリをクローンする；

• Opencode（またはMCPをサポートする他のAIエージェント）がインストールされ、設定されていること；

• Node.js（>= LTS推奨）

• パッケージマネージャー（npmまたはyarn）

依存関係のインストール

プロジェクトのルートで、次のコマンドを実行します：

npm install

# ou:

yarn install

サーバーの実行

MCPサーバー（stdio 経由）：

npm run start:stdio

# ou:

yarn start:stdio

MCPサーバー（HTTP 経由）：

npm run start:http

# ou:

yarn start:http

MCPサーバー（Express 統合）：

npm run start:express

# ou:

yarn start:express

メンターエージェントの実行（Opencodeの例）

Opencodeがインストールされている状態で、リポジトリのディレクトリで任意のターミナルを開き、次のコマンドを実行します：

opencode

最初の実行ではOpencodeのすべての依存関係がダウンロードされるため、プロセスの完了を待ってください。Mentor エージェントがデフォルトで選択されています。

MCPサーバーとAIエージェントの統合

• Opencode: MCPサーバー；

• Claude: MCPを介してClaude Codeをツールに接続；

• Codex: Model Context Protocol；

• Cursor: Model Context Protocol (MCP)；

• Antigravity: Model Context Protocol (MCP)。

サンプルプロンプト

エージェントを使用してリポジトリの tools と対話するためのいくつかの例：

nordesul-delivery

Quais são os padrões de implementação para a área de checkout do Nordesul?

nordesul-deploy

Antes de eu publicar essa mudança no Nordesul, quais cuidados devo tomar?

nordesul-reference

Me mostra a documentação da API de pedidos (orders) do Nordesul.

nordesul-status

Qual o status atual da aplicação checkout-service no Nordesul?