読み込み中

クライアントでのプロンプト

レッスン 577 分
読み込み中

MCPクライアントを構築する最後のステップは、プロンプト機能の実装です。これにより、サーバーから利用可能なすべてのプロンプトを一覧表示し、変数が補間された特定のプロンプトを取得できるようになります。

プロンプト一覧の実装

list_prompts メソッドは単純です。セッションのプロンプト一覧取得メソッドを呼び出し、プロンプトを返すだけです。

python
async def list_prompts(self) -> list[types.Prompt]:
    result = await self.session().list_prompts()
    return result.prompts

個々のプロンプトの取得

get_prompt メソッドは、引数の補間を処理するため、より興味深いものです。特定のプロンプトをリクエストすると、プロンプト関数に注入される引数を渡します。例えば、サーバーに doc_id パラメータを期待する「format」プロンプトがある場合、その値が渡され、実際のプロンプトテキストに補間されます。

python
async def get_prompt(self, prompt_name, args: dict[str, str]):
    result = await self.session().get_prompt(prompt_name, args)
    return result.messages

このメソッドは、Claudeに直接渡す準備が整った会話を構成するメッセージを返します。

実際にプロンプトをテストする

クライアントを実行してスラッシュを入力すると、利用可能なプロンプトがコマンドとして表示されます。「format」のようなプロンプトを選択すると、利用可能なドキュメントから選択するよう求められます。システムは次のように動作します。

  • ドキュメントIDが補間されたプロンプトを取得する
  • それをユーザーメッセージとしてClaudeに直接渡す
  • Claudeは指示とドキュメントIDの両方を受け取る
  • Claudeは利用可能なツールを使ってドキュメントの内容を取得する
  • Claudeが再フォーマットされた結果で応答する

クライアントでスラッシュを入力すると「/format」が一覧表示され、これはMarkdown形式でドキュメントの内容を書き換えます。

プロンプトの仕組み

プロンプトは、クライアントが使用できる一連のユーザーメッセージとアシスタントメッセージを定義します。これらのプロンプトは高品質で、十分にテストされており、MCPサーバー全体の目的に関連している必要があります。

MCPサーバーコード: @mcp.promptは、format_document関数を使ってドキュメントをMarkdownで書き換える「format」プロンプトを指定します。

ワークフローは次のとおりです。

  1. MCPサーバーの目的に関連するプロンプトを作成し、評価する
  2. @mcp.prompt デコレータを使用してMCPサーバー内にプロンプトを定義する
  3. クライアントはいつでもそのプロンプトをリクエストできる
  4. プロンプトをリクエストする際、プロンプト関数にキーワード引数として渡される引数を指定する
  5. 関数はそれらの引数を使用してプロンプトの内容をカスタマイズする

このシステムにより、再利用可能でパラメータ化されたプロンプトが作成され、異なるクライアントやユースケース間で共有できるようになり、MCPサーバーがより汎用的で強力なものになります。