Quick Example

🚀 MCP プロトコルを使用した大規模言語モデル（LLM）との標準化されたインタラクションサーバー

モデルコンテキストプロトコル（Model Context Protocol, MCP） は、アプリケーションが大規模言語モデルにコンテキストを提供する方法を統一するためのオープンプロトコルです。言い換えると、LLM ベースのアプリケーションがデータソースに接続し、ツールを使用し、標準的なプロンプトを実行するための統一されたフレームワークを提供します。

MCP エコシステムは、3 つの具体的なコンポーネントを定義しています。

• MCP サーバー：ツールの可用性（公開されている機能）、ツールの実行（要求された機能の実行）、リソースとしての静的コンテンツ（参照可能なデータの提供）、プリセットプロンプト（一般的なタスクの標準テンプレート）を担当します。
• クライアント：サーバーとの接続、LLM の統合、コンポーネント間のメッセージ伝達を管理します。
• ホスト：フロントエンドインターフェイスを提供し、ユーザーに MCP の機能を表示し、エコシステム全体との統合ポイントとなります。

このアーキテクチャは、異なるコンポーネントが独立して開発できるモジュール式システムを作成し、同時に相互運用性を維持します。これにより、ユーザーは異なる LLM 関連機能を持つ MCP サーバーを構築し、サポートされている様々なアプリケーションでプラグイン式に使用できます。通常、サービス API やツールの統合、またはローカルデータソースへの接続に使用されます。

✨ 主な機能

MCP サーバーコンポーネント

MCP サーバーは、明確に定義されたインターフェイスを介して標準化された機能を公開し、プロトコルの基礎を構成します。ホストとクライアントは、このプロトコル標準を介してこれらのサーバーに接続できますが、これらの機能をユーザーにどのように提示するかは、開発者が柔軟に決定できます。つまり、実際の実装とユーザー体験は、コマンドラインインターフェイス、グラフィックアプリケーション、またはより大きなシステムに埋め込まれたものなど、開発者が自由に設計できます。

このガイドでは、核心機能を持つ MCP サーバーの例を構築し、簡単なクライアント実装を添付して、インタラクションモードをデモンストレーションします。まず、MCP サーバーの主要コンポーネントを概説しましょう。

ツール

ツールは、LLM が操作を実行または情報を取得するために呼び出すことができる機能です。各ツールの定義は次のとおりです。

{
  name: string;          // ツールの一意の識別子
  description?: string;  // 人間が読める説明
  inputSchema: {         // ツールパラメータの JSON スキーマ
    type: "object",
    properties: { ... }  // ツール固有のパラメータ
  }
}

ツールにより、LLM は外部システムとの相互作用、コードの実行、データベースのクエリ、または計算を行うことができます。これらは、効果を生み出すか、新しい情報を生成することができるアクションを表します。

リソース

リソースは、クライアントアプリケーションがアクセスできるデータソースを表します。これらは URI で識別され、次の要素を含みます。

{
  uri: string;           // リソースの一意の識別子
  name: string;          // 人間が読める名前
  description?: string;  // オプションの説明
  mimeType?: string;     // オプションの MIME タイプ
}

プロンプト

プロンプトは、LLM に特定のタスクを実行するように指示するための事前定義された命令です。これらには、コンテキスト情報、入力パラメータなどが含まれる場合があります。

📦 インストール

サンプルプロジェクトのセットアップとインストール

1. リポジトリをクローンします。

git clone https://github.com/ALucek/quick-mcp-example.git
cd quick-mcp-example

2. ChromaDB データベースを作成します。 MCP_setup.ipynb の説明に従って、ベクトルデータベースを作成し、PDF ファイルを埋め込みます。
3. 仮想環境を作成し、依存関係をインストールします。

# uv を使用することをおすすめします
uv venv
source .venv/bin/activate  # macOS/Linux の場合
# または
.venv\Scripts\activate     # Windows の場合

# 依存関係をインストールします
uv sync

4. クライアントとサーバーを実行します。

python client.py mcp_server.py