読み込み中
MCPクライアントとサーバーがどのように連携して動作するかをより深く理解するために、自分たちでCLIベースのチャットボットを構築していきます。このハンズオン形式のプロジェクトを通じて、MCPアーキテクチャの両面について実践的な経験を積むことができます。
これから構築するもの
このチャットボットは、ユーザーが一連のドキュメントとチャットできるコマンドラインインターフェースです。システムには以下が含まれます。
- CLIベースのチャットボットインターフェース
- Claudeによるドキュメントの読み取りおよび編集機能
@doc_name構文を使用したドキュメントの「メンション」機能/command_name構文によるコマンド実行- メモリ内に保存された架空のドキュメント群

システムアーキテクチャ
このプロジェクトは、互いに連携する3つの主要コンポーネントで構成されています。
- 私たちのMCPクライアント - ユーザーとのやり取りとチャットインターフェースを処理します
- 私たちのMCPサーバー - ドキュメント操作のためのツールを提供します
- ドキュメントストレージ - さまざまなファイルタイプのメモリ内コレクション

MCPサーバーは、2つのコアツールを実装します。
- ドキュメントの内容を読み取るツール
- ドキュメントの内容を更新するツール
すべてのドキュメント(PDF、スプレッドシート、テキストファイル、Markdownファイル)は、ディスク上ではなくメモリ内に保存され、プロジェクトをシンプルに保ちつつMCPの概念に焦点を当てられるようにしています。
アーキテクチャに関する重要な注意点
実際のプロジェクトでは、通常はMCPクライアントかMCPサーバーのどちらか一方を実装します。両方を実装することはありません。たとえば、次のようなことを行うでしょう。
- 他の開発者にサービスを配布するためのMCPサーバーを構築する
- 既存のサードパーティ製MCPサーバーに接続するMCPクライアントを構築する

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