読み込み中

クライアントにおけるプロンプト

レッスン 569 分
読み込み中

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

ドキュメントの内容をMarkdown形式で書き換える「format」という名前のプロンプトを定義しているMCPサーバーのコード。

list_promptsの実装

最初のステップは、MCPクライアントでlist_promptsメソッドを実装することです。このメソッドは、サーバーから利用可能なすべてのプロンプトを取得します。

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

このシンプルな実装は、セッションのlist_promptsメソッドを呼び出し、結果からプロンプトの配列を返します。

個々のプロンプトの取得

get_promptメソッドは、引数が補間された特定のプロンプトを取得します。プロンプトをリクエストする際には、プロンプト関数にキーワード引数として渡される引数を指定します。

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に直接渡すことができる会話を形成します。

プロンプトの引数の仕組み

サーバー側でプロンプト関数を定義する際、パラメータを受け取ることができます。たとえば、ドキュメントのフォーマット用プロンプトは、doc_idパラメータを期待する場合があります。

python
def format_document(doc_id: str):
    # doc_idはプロンプトに埋め込まれます

クライアントがget_promptを呼び出すと、引数の辞書には期待されるキーが含まれている必要があります。MCPサーバーはこれらをキーワード引数としてプロンプト関数に渡し、プロンプトテンプレートに動的なコンテンツを挿入できるようにします。

CLIでのプロンプトのテスト

実装が完了したら、コマンドラインインターフェースを通じてプロンプトをテストできます。スラッシュを入力すると、利用可能なプロンプトがコマンドとして表示されます。プロンプトを選択すると、利用可能な選択肢(ドキュメントIDなど)から選ぶよう求められる場合があり、その後、完全なプロンプトがClaudeに送信されます。

「/format plan.md」と入力された状態でuv run main.pyを実行しているターミナルと、plan.mdがハイライトされたファイルのオートコンプリートリスト。

ワークフローは次のようになります。

  1. ユーザーがプロンプト(「format」など)を選択する
  2. システムが必要な引数(フォーマットするドキュメントなど)を求める
  3. 補間された値とともにプロンプトがClaudeに送信される
  4. Claudeはツールを使用して追加のデータを取得し、タスクを完了できる

「Development Team 5 FTE Phases 1-5」と記載されたリソーステーブルの行とRisk Managementセクションを含むターミナルのMarkdown。

プロンプトのベストプラクティス

MCPサーバー用のプロンプトを作成する際には、以下の点に注意してください。

  • サーバーの目的に関連したものにする
  • デプロイ前に十分にテストする
  • 明確で具体的な指示を使用する
  • 利用可能なツールとうまく連携するように設計する
  • ユーザーがどのような引数を提供する必要があるかを考慮する

プロンプトは、事前定義された機能と動的なユーザーのニーズの間のギャップを埋め、パラメータ化による柔軟性を維持しながら、Claudeに複雑なタスクのための構造化された出発点を与えます。