mcp

Model Context Protocol (MCP) の基礎知識

MCPとは

Model Context Protocol (MCP) は、大規模言語モデル (LLM) とツールを接続するための標準プロトコルです。MCPを使用することで、LLMはさまざまなツールやリソースにアクセスし、より複雑なタスクを実行できるようになります。

MCPの主要コンポーネント

MCPは以下の主要なコンポーネントで構成されています：

1. MCPサーバー: ツール、リソース、プロンプトを提供するサーバー
2. MCPクライアント: サーバーに接続し、ツールを呼び出すクライアント
3. LLM: クライアントからの入力を処理し、必要に応じてツールを呼び出す

MCPの主な機能

1. ツール (Tools)

ツールは、LLMが実行できる特定の機能を提供します。例えば：

• データベースクエリの実行
• 外部APIの呼び出し
• ファイルの読み書き
• 計算の実行

各ツールは名前、説明、パラメータスキーマ、戻り値スキーマを持ちます。

2. リソース (Resources)

リソースは、LLMがアクセスできるデータソースです。例えば：

• ドキュメント
• データベース
• コードリポジトリ
• 設定ファイル

リソースはURIで識別され、読み取り/書き込みアクセスが可能です。

3. プロンプト (Prompts)

プロンプトは、LLMに特定のタスクを実行させるための指示です。MCPサーバーは、特定のユースケース向けに最適化されたプロンプトを提供できます。

MCPの通信フロー

1. クライアントがサーバーに接続: MCPクライアントがMCPサーバーに接続します
2. ツール一覧の取得: クライアントがサーバーから利用可能なツールの一覧を取得します
3. ユーザー入力の処理: ユーザーからの入力をLLMに送信します
4. ツールの呼び出し: LLMが必要に応じてツールを呼び出します
5. 結果の返却: ツールの実行結果をLLMに返し、LLMが最終的な応答を生成します

MCPの実装方法

サーバー側

# FastMCPを使用した例
from fastmcp import FastMCP

# サーバーの作成
mcp = FastMCP(
    "Example MCP Server",
    host="0.0.0.0",
    port=52229
)

# ツールの定義
@mcp.tool()
def example_tool(param1: str, param2: int) -> dict:
    """
    Example tool description.
    
    Args:
        param1: First parameter description
        param2: Second parameter description
        
    Returns:
        Dict containing results
    """
    # ツールの実装
    return {"result": f"{param1}: {param2}"}

# サーバーの実行
if __name__ == "__main__":
    mcp.run()

クライアント側

# 基本的なMCPクライアント
import requests

class MCPClient:
    def __init__(self, base_url: str = "http://localhost:52229"):
        self.base_url = base_url.rstrip("/")
        self.headers = {
            "Content-Type": "application/json",
        }
    
    def call_tool(self, tool_name: str, params: dict) -> dict:
        """ツールを呼び出す"""
        url = f"{self.base_url}/api/tools/{tool_name}"
        
        try:
            response = requests.post(url, headers=self.headers, json=params)
            response.raise_for_status()
            return response.json()
        except requests.RequestException as e:
            return {"error": str(e), "status": "error"}