読み込み中

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

レッスン 501 分
読み込み中

MCPクライアントとサーバーがどのように連携して動作するかをより深く理解するために、自分たちでCLIベースのチャットボットを構築していきます。このハンズオン形式のプロジェクトを通じて、MCPアーキテクチャの両面について実践的な経験を積むことができます。

これから構築するもの

このチャットボットは、ユーザーが一連のドキュメントとチャットできるコマンドラインインターフェースです。システムには以下が含まれます。

  • CLIベースのチャットボットインターフェース
  • Claudeによるドキュメントの読み取りおよび編集機能
  • @doc_name 構文を使用したドキュメントの「メンション」機能
  • /command_name 構文によるコマンド実行
  • メモリ内に保存された架空のドキュメント群

プロンプトで@と入力すると、deposition.md、design.md、financials.md、outlook.md、plan.md、spec.mdが一覧表示され、すべて「Resource」とラベル付けされています。

システムアーキテクチャ

このプロジェクトは、互いに連携する3つの主要コンポーネントで構成されています。

  • 私たちのMCPクライアント - ユーザーとのやり取りとチャットインターフェースを処理します
  • 私たちのMCPサーバー - ドキュメント操作のためのツールを提供します
  • ドキュメントストレージ - さまざまなファイルタイプのメモリ内コレクション

私たちのサーバーには私たちのMCPクライアントが含まれており、これが私たちのMCPサーバーと双方向にやり取りし、そのツールが4つのドキュメントを読み取り・更新します。

MCPサーバーは、2つのコアツールを実装します。

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

すべてのドキュメント(PDF、スプレッドシート、テキストファイル、Markdownファイル)は、ディスク上ではなくメモリ内に保存され、プロジェクトをシンプルに保ちつつMCPの概念に焦点を当てられるようにしています。

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

実際のプロジェクトでは、通常はMCPクライアントかMCPサーバーのどちらか一方を実装します。両方を実装することはありません。たとえば、次のようなことを行うでしょう。

  • 他の開発者にサービスを配布するためのMCPサーバーを構築する
  • 既存のサードパーティ製MCPサーバーに接続するMCPクライアントを構築する

私たちのサーバーにはMCPクライアントが含まれており、これが別のMCPサーバーと双方向に接続している図。

私たちのプロジェクトでは、クライアントとサーバーがどのように相互作用するかを理解できるように、純粋に教育目的で両方のコンポーネントを単一のコードベースに実装しています。