読み込み中

プロンプトを定義する

レッスン 85 分

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

Toolsと、Resourcesと、ハイライトされたPromptsを外部サービスの前に公開する2つのMCPサーバーに接続するMCPクライアントの図

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

ここで重要な洞察があります。ユーザーはすでにほとんどのタスクをClaudeに直接依頼できます。例えば、ユーザーが「report.pdfをmarkdownに再フォーマットして」と入力すれば、それなりの結果が得られるでしょう。しかし、エッジケースを処理し、ベストプラクティスに従う、十分にテストされた専用のプロンプトを提供すれば、はるかに良い結果が得られます。

MCPサーバーの作者として、さまざまなシナリオで一貫して機能するプロンプトを作り込み、テストし、評価する時間をかけることができます。ユーザーは、自分自身がプロンプトエンジニアリングの専門家になる必要なく、この専門知識の恩恵を受けられます。

ユーザーが書くであろう短いプロンプト「report.pdfをmarkdownに変換して」と、MCPサーバーの作者が代わりに提供できる、はるかに長く十分に評価されたプロンプトとの比較

フォーマットコマンドを構築する

実践的な例を実装してみましょう。ドキュメントをmarkdownに変換するフォーマットコマンドです。ユーザーは /format doc_id と入力し、プロフェッショナルにフォーマットされたmarkdown版のドキュメントを受け取ります。

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

  • ユーザーが / と入力して利用可能なコマンドを確認する
  • format を選択し、ドキュメントIDを指定する
  • Claudeがあらかじめ用意されたプロンプトを使ってドキュメントを読み込み、再フォーマットする
  • 結果として、適切な見出し、リスト、フォーマットを備えたクリーンなmarkdownが得られる

プロンプトを定義する

プロンプトは、ツールやリソースと似たデコレーターパターンを使用します。

python
from mcp.server.fastmcp.prompts import base

@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]:
    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:
<document_id>
{doc_id}
</document_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)
    ]

この関数は、Claudeに直接送信されるメッセージのリストを返します。複数のユーザーメッセージとアシスタントメッセージを含めることで、より複雑な会話フローを作成できます。

プロンプトをテストする

デプロイする前に、MCP Inspectorを使ってプロンプトをテストしましょう。

formatプロンプトが選択されたMCP Inspector。doc_id引数と、Claudeに送信される補間済みメッセージが表示されている

インスペクターは、変数がプロンプトテンプレートにどのように補間されるかを含め、Claudeに送信される正確なメッセージを表示します。これにより、ユーザーが依存し始める前に、プロンプトが正しく見えるかどうかを確認できます。

主な利点

  • 一貫性 - ユーザーは毎回信頼できる結果を得られます
  • 専門知識 - ドメイン知識をプロンプトに組み込むことができます
  • 再利用性 - 複数のクライアントアプリケーションが同じプロンプトを使用できます
  • メンテナンス性 - 1か所でプロンプトを更新すれば、すべてのクライアントを改善できます

プロンプトは、あなたのMCPサーバーのドメインに特化している場合に最も効果を発揮します。ドキュメント管理サーバーには、フォーマット、要約、ドキュメント分析のためのプロンプトがあるかもしれません。データ分析サーバーには、レポートや可視化を生成するためのプロンプトがあるかもしれません。

目標は、ユーザーが自分でゼロから指示を書くよりも好んで使いたくなるほど、よく作り込まれ、テストされたプロンプトを提供することです。