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

list_promptsの実装
最初のステップは、MCPクライアントでlist_promptsメソッドを実装することです。このメソッドは、サーバーから利用可能なすべてのプロンプトを取得します。
async def list_prompts(self) -> list[types.Prompt]:
result = await self.session().list_prompts()
return result.promptsこのシンプルな実装は、セッションのlist_promptsメソッドを呼び出し、結果からプロンプトの配列を返します。
個々のプロンプトの取得
get_promptメソッドは、引数が補間された特定のプロンプトを取得します。プロンプトをリクエストする際には、プロンプト関数にキーワード引数として渡される引数を指定します。
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パラメータを期待する場合があります。
def format_document(doc_id: str):
# doc_idはプロンプトに埋め込まれますクライアントがget_promptを呼び出すと、引数の辞書には期待されるキーが含まれている必要があります。MCPサーバーはこれらをキーワード引数としてプロンプト関数に渡し、プロンプトテンプレートに動的なコンテンツを挿入できるようにします。
CLIでのプロンプトのテスト
実装が完了したら、コマンドラインインターフェースを通じてプロンプトをテストできます。スラッシュを入力すると、利用可能なプロンプトがコマンドとして表示されます。プロンプトを選択すると、利用可能な選択肢(ドキュメントIDなど)から選ぶよう求められる場合があり、その後、完全なプロンプトがClaudeに送信されます。

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

プロンプトのベストプラクティス
MCPサーバー用のプロンプトを作成する際には、以下の点に注意してください。
- サーバーの目的に関連したものにする
- デプロイ前に十分にテストする
- 明確で具体的な指示を使用する
- 利用可能なツールとうまく連携するように設計する
- ユーザーがどのような引数を提供する必要があるかを考慮する
プロンプトは、事前定義された機能と動的なユーザーのニーズの間のギャップを埋め、パラメータ化による柔軟性を維持しながら、Claudeに複雑なタスクのための構造化された出発点を与えます。