読み込み中

プロジェクトのセットアップ

レッスン 517 分
読み込み中

ここでは、MCPクライアントとサーバーがどのように連携して動作するかを示す、CLIベースのチャットボットを構築します。このハンズオン プロジェクトを通じて、MCPアーキテクチャの両側について実践的な経験を得ることができます。

構築するもの

私たちのチャットボットは、自然言語を通じてユーザーがドキュメントのコレクションとやり取りできるようにします。このシステムは2つの主要なコンポーネントで構成されます。

  • ユーザーとのやり取りを処理し、Claudeと通信するMCPクライアント
  • ドキュメントの読み取りと更新のためのツールを提供するMCPサーバー

サーバーにはMCPクライアントが格納されており、それがMCPサーバーと双方向にやり取りし、MCPサーバーのツールが4つのドキュメントを読み取りおよび更新します。

サーバーはClaudeに2つのツールを公開します。

  • ドキュメントの内容を読み取るツール
  • ドキュメントの内容を更新するツール

すべてのドキュメントは簡単にするためメモリ上に保存されます。これにはdocument.pdf、spreadsheet.xlsx、report.txt、spec.mdといったファイルが含まれます。

重要なアーキテクチャに関する注意

実際のプロジェクトでは、通常MCPクライアントかMCPサーバーのどちらか一方を実装し、両方を実装することはありません。構築するものとしては以下が考えられます。

  • AIモデルにサービスの機能を公開するためのMCPサーバーのみ
  • 他の開発者が構築した既存のMCPサーバーに接続するためのMCPクライアントのみ

MCPクライアントを含む私たちのサーバーが、別のMCPサーバーに双方向で接続している図。

このプロジェクトで両方のコンポーネントを構築するのは、あくまで教育目的で、両者がどのように通信し連携して動作するかを理解するためです。

プロジェクトのセットアップ

このレッスンの最後にあるダウンロード セクションからcli_project.zipをダウンロードし、お好みの開発用ディレクトリに展開してください。プロジェクト フォルダでコード エディタを開きます。

設定

このプロジェクトには、詳細なセットアップ手順が記載されたREADME.mdファイルが含まれています。以下の作業が必要になります。

  1. .envファイルにAnthropic APIキーを追加する
  2. UV(推奨)またはpipのいずれかを使用して依存関係をインストールする

プロジェクトのREADME.md。ステップ1では.envファイルにANTHROPIC_API_KEYを設定し、ステップ2では依存関係をインストールします。

.envファイルには次の内容を含める必要があります。

bash
ANTHROPIC_API_KEY="your-api-key-here"

プロジェクトの実行

セットアップが完了したら、ターミナルでプロジェクト ディレクトリに移動し、以下を実行してください。

bash
# UVを使用する場合(推奨)
uv run main.py

# 標準のPythonを使用する場合
python main.py

チャット プロンプトが表示されるはずです。「what's 1+1?」のような簡単な質問をしてみて、すべてが正しく動作していることを確認してください。

スターター プロジェクトにはすでにClaudeとの基本的なチャット機能が含まれています。次の動画では、MCPサーバーの機能とドキュメント管理機能を追加し、ドキュメントを認識できる完全に機能するチャットボットを作成していきます。

ダウンロード

  • Starter project (cli_project.zip)

    The chatbot project you build on for the rest of this section.

    ダウンロード
  • Completed project (cli_project_COMPLETE.zip)

    The finished version, for checking your work.

    ダウンロード