読み込み中

プロンプトの定義

レッスン 569 分
読み込み中

MCPサーバーはプロンプト、つまりクライアントが自分でプロンプトを一から書く代わりに使用できる、あらかじめ用意された高品質な指示を定義できます。プロンプトは、ユーザーが自分で書くものよりも優れた結果をもたらす、入念に作られたテンプレートだと考えてください。

なぜプロンプトを使うのか

Claudeにドキュメントをmarkdownに再フォーマットさせたいとします。単に「report.pdfをmarkdownに変換して」と依頼すればうまくいくでしょう。しかし、エッジケースをカバーし、具体的なフォーマット指示を与える、十分にテストされた詳細なプロンプトを使えば、おそらくはるかに良い結果が得られます。

ユーザーの一行プロンプトと、Claudeをドキュメント変換の専門家に仕立てたサーバー側の長いプロンプトを並べて比較した図。

考え方はシンプルです。MCPサーバー開発者として、私たちは本当に優れたプロンプトを作成・テストする時間をかけ、それを自分たちのサーバーを使うすべての人に提供できます。ユーザーは自分自身がプロンプトエンジニアリングの専門家になる必要なく、より良い結果を得られるのです。

プロンプトを定義する

プロンプトは、ツールやリソースと似たデコレーターパターンを使用します。基本的な構造は次のとおりです。

python
@mcp.prompt(
    name="format",
    description="Rewrites the contents of the document in Markdown format."
)
def format_document(
    doc_id: str = Field(description="Id of the document to format")
) -> list[base.Message]:
    # メッセージのリストを返します

この関数は、Claudeに直接送信できるメッセージのリストを返します。これにより、必要に応じて複数のユーザーメッセージとアシスタントメッセージを含む複雑なプロンプトを構築できます。

フォーマットプロンプトを構築する

このドキュメントサーバー用に、ドキュメントをmarkdownに再フォーマットするプロンプトを作成します。このプロンプトは次のことを行う必要があります。

  • 入力としてドキュメントIDを受け取る
  • read_doc_contents ツールを使ってドキュメントを取得する
  • 適切なmarkdown構文で再フォーマットする
  • 変更をドキュメントに保存し直す

実装は次のようになります。

python
def format_document(
    doc_id: str = Field(description="Id of the document to format")
) -> list[base.Message]:
    prompt = f"""
Your goal is to reformat a document to be written with markdown syntax.

The id of the document you need to reformat is:

{doc_id}


Add in headers, bullet points, tables, etc as necessary. Feel free to add in structure.
Use the 'edit_document' tool to edit the document. After the document has been reformatted...
"""
    
    return [
        base.UserMessage(prompt)
    ]

プロンプトをテストする

プロンプトを定義したら、MCP Inspectorを使ってテストできます。Promptsタブに移動し、プロンプトを選択して、必要なパラメータを指定します。

MCP InspectorのPromptsタブ:doc_idをoutlook.pdfに設定した「format」プロンプトと、生成されたユーザーメッセージ。

Inspectorは、Claudeに送信されるであろう生成済みのメッセージを表示します。パラメータの補間が正しく機能しているか、プロンプトに必要な指示がすべて含まれているかを確認できます。

主な利点

  • 品質管理 - サーバーの作者は、ユーザーに見せる前にプロンプトをテストし、磨き上げることができます
  • 一貫性 - 誰もが即興で作るのではなく、同じ高品質なプロンプトを得られます
  • 専門化 - プロンプトをサーバー固有のドメインや機能に合わせて調整できます
  • 再利用性 - 複数のクライアントアプリケーションが同じ、よく練られたプロンプトを使用できます

メッセージタイプ用のベースモジュールをインポートすることを忘れないでください。

python
from mcp.server.fastmcp.prompts import base

プロンプトは、ドキュメント管理、データ分析、コード生成など、MCPサーバーが特定の分野に特化している場合に特に価値を発揮します。サーバーのツールを効果的に活用する、実戦で鍛えられたプロンプトをユーザーに提供できます。