読み込み中

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

レッスン 587 分
読み込み中

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

List Promptsの実装

list_prompts メソッドはシンプルです。セッションの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に直接渡せる状態の会話を構成するメッセージを返します。

プロンプト引数の仕組み

MCPサーバーでプロンプト関数を定義すると、そのパラメータは補間変数として利用できるようになります。get_prompt に渡す引数辞書は、これらのパラメータの値を提供します。サーバーはその後、適切な箇所に値を代入した完全なプロンプトを生成します。

mcp_server.pyのコードで「format」プロンプトを定義している様子:その doc_id 引数が document_id タグの間に補間されている。

実装のテスト

実装が完了したら、CLIでプロンプトをテストできます。スラッシュを入力すると、利用可能なプロンプトがコマンドとして表示されます。「format」のようなプロンプトを選択すると、必要な引数(フォーマットするドキュメントの選択など)の値を選ぶよう促されます。その後、システムは次のように動作します。

  1. あなたが指定した引数が補間された状態でプロンプトを取得する
  2. 完全なプロンプトをClaudeに送信する
  3. Claudeがリクエストを達成するために必要なツール呼び出しを実行する
  4. フォーマットされた結果を返す

MCPサーバーのコード:@mcp.prompt が、ドキュメントをMarkdownで書き直す「format」プロンプトを、format_document関数とともに定義している。

実践でのプロンプト

プロンプトは、クライアントが呼び出せる再利用可能なユーザーメッセージとアシスタントメッセージのセットを定義します。これらは高品質で、十分にテストされ、MCPサーバーの目的に関連したものであるべきです。サーバーのツールとリソースを組み合わせて特定のタスクを達成する、事前に構築されたワークフローだと考えてください。

プロンプトシステムは、プロンプトのロジック(サーバー側で定義)と実行(クライアントとClaudeが処理)の間に明確な分離を作り出します。これにより、ユーザーがシンプルなコマンドでトリガーできる、洗練されたマルチステップのワークフローを簡単に作成できるようになります。