ここでは、MCPクライアントとサーバーがどのように連携して動作するかを示す、CLIベースのチャットボットを構築します。このハンズオン プロジェクトを通じて、MCPアーキテクチャの両側について実践的な経験を得ることができます。
構築するもの
私たちのチャットボットは、自然言語を通じてユーザーがドキュメントのコレクションとやり取りできるようにします。このシステムは2つの主要なコンポーネントで構成されます。
- ユーザーとのやり取りを処理し、Claudeと通信するMCPクライアント
- ドキュメントの読み取りと更新のためのツールを提供するMCPサーバー

サーバーはClaudeに2つのツールを公開します。
- ドキュメントの内容を読み取るツール
- ドキュメントの内容を更新するツール
すべてのドキュメントは簡単にするためメモリ上に保存されます。これにはdocument.pdf、spreadsheet.xlsx、report.txt、spec.mdといったファイルが含まれます。
重要なアーキテクチャに関する注意
実際のプロジェクトでは、通常MCPクライアントかMCPサーバーのどちらか一方を実装し、両方を実装することはありません。構築するものとしては以下が考えられます。
- AIモデルにサービスの機能を公開するためのMCPサーバーのみ
- 他の開発者が構築した既存のMCPサーバーに接続するためのMCPクライアントのみ

このプロジェクトで両方のコンポーネントを構築するのは、あくまで教育目的で、両者がどのように通信し連携して動作するかを理解するためです。
プロジェクトのセットアップ
このレッスンの最後にあるダウンロード セクションからcli_project.zipをダウンロードし、お好みの開発用ディレクトリに展開してください。プロジェクト フォルダでコード エディタを開きます。
設定
このプロジェクトには、詳細なセットアップ手順が記載されたREADME.mdファイルが含まれています。以下の作業が必要になります。
- .envファイルにAnthropic APIキーを追加する
- UV(推奨)またはpipのいずれかを使用して依存関係をインストールする

.envファイルには次の内容を含める必要があります。
ANTHROPIC_API_KEY="your-api-key-here"プロジェクトの実行
セットアップが完了したら、ターミナルでプロジェクト ディレクトリに移動し、以下を実行してください。
# UVを使用する場合(推奨)
uv run main.py
# 標準のPythonを使用する場合
python main.pyチャット プロンプトが表示されるはずです。「what's 1+1?」のような簡単な質問をしてみて、すべてが正しく動作していることを確認してください。
スターター プロジェクトにはすでにClaudeとの基本的なチャット機能が含まれています。次の動画では、MCPサーバーの機能とドキュメント管理機能を追加し、ドキュメントを認識できる完全に機能するチャットボットを作成していきます。