Azure Functionsの MCP プロンプト トリガー (パブリック プレビュー)

このバインドに関しては現在、Goのサポートは利用できません。

このコードは、コード レビュー プロンプトを公開するエンドポイントを作成します。

[Function(nameof(CodeReviewChecklist))]
public string CodeReviewChecklist(
    [McpPromptTrigger(CodeReviewPromptName, Description = CodeReviewPromptDescription)]
        PromptInvocationContext context)
{
    logger.LogInformation("Code review checklist prompt invoked.");

    return """
        You are a senior software engineer performing a code review.
        Use the following checklist to evaluate the code:

        1. **Correctness** — Does the code do what it's supposed to?
        2. **Error Handling** — Are edge cases and failures handled?
        3. **Security** — Are there any vulnerabilities (injection, auth, secrets)?
        4. **Performance** — Are there obvious inefficiencies?
        5. **Readability** — Is the code clear and well-named?
        6. **Tests** — Are there adequate tests for the changes?

        Provide your feedback in a structured format with a severity level
        (critical, warning, suggestion) for each finding.
        """;
}

このコードは、 topic と audienceの 2 つの引数を受け取る要約プロンプトを公開するエンドポイントを作成します。

[Function(nameof(SummarizeContent))]
public string SummarizeContent(
    [McpPromptTrigger(SummarizePromptName, Description = SummarizePromptDescription)]
        PromptInvocationContext context,
    [McpPromptArgument("topic", "The topic or content to summarize.", isRequired: true)]
        string topic,
    [McpPromptArgument("audience", "Target audience (e.g., 'executive', 'developer', 'beginner').")]
        string? audience)
{
    logger.LogInformation("Summarize prompt invoked for topic: {Topic}", topic);

    var audienceInstruction = audience is not null
        ? $"Tailor the summary for a **{audience}** audience."
        : "Write the summary for a general technical audience.";

    return $"""
        Summarize the following topic concisely and accurately:

        **Topic:** {topic}

        {audienceInstruction}

        Guidelines:
        - Start with a one-sentence overview.
        - Include 3–5 key points as bullet items.
        - End with a brief conclusion or recommendation.
        - Keep the total length under 300 words.
        """;
}

Program.cs ビルダーを使用して、プロンプトのプロンプト引数を ConfigureMcpPrompt で構成することもできます。

var builder = FunctionsApplication.CreateBuilder(args);

builder.ConfigureFunctionsWebApplication();

builder
    .ConfigureMcpPrompt(SummarizePromptName)
    .WithArgument("topic", "The topic or content to summarize.", required: true)
    .WithArgument("audience", "Target audience (e.g., 'executive', 'developer', 'beginner').");

builder.Build().Run();

完全なコード例については、GitHubの FunctionsMcpPrompts サンプルを参照してください。

このコードは、複数の引数 (1 つは必須、1 つは省略可能) を含むコード レビュー プロンプトを公開するエンドポイントを作成します。

@FunctionName("CodeReviewPrompt")
public String codeReviewPrompt(
        @McpPromptTrigger(
                name = "code_review",
                description = "Generates a code review prompt for the given code snippet",
                title = "Code Review")
        String context,
        @McpPromptArgument(
                name = "code",
                description = "The code to review",
                isRequired = true)
        String code,
        @McpPromptArgument(
                name = "language",
                description = "The programming language")
        String language,
        final ExecutionContext executionContext) {

    executionContext.getLogger().info("Generating code review prompt");

    String lang = (language != null && !language.isEmpty()) ? language : "unknown";
    String snippet = (code != null && !code.isEmpty()) ? code : "// no code provided";

    return "Please review the following " + lang + " code and suggest improvements:\n\n```"
            + lang + "\n" + snippet + "\n```";
}

このコードでは、1 つの必須引数を含む集計プロンプトを公開するエンドポイントを作成します。

@FunctionName("SummarizePrompt")
public String summarizePrompt(
        @McpPromptTrigger(
                name = "summarize",
                description = "Summarizes the provided text",
                title = "Summarize Text")
        String context,
        @McpPromptArgument(
                name = "text",
                description = "The text to summarize",
                isRequired = true)
        String text,
        final ExecutionContext executionContext) {

    executionContext.getLogger().info("Generating summarize prompt");

    String input = (text != null && !text.isEmpty()) ? text : "No text provided";
    return "Please provide a concise summary of the following text:\n\n" + input;
}

完全なコード例については、GitHubの PromptExamples.java サンプルを参照してください。

<extensionBundle>
  <id>Microsoft.Azure.Functions.ExtensionBundle.Preview</id>
  <version>[4.41, 5.0.0)</version>
</extensionBundle>

JavaScript のコード例は現在使用できません。 Node.jsを使用した一般的なガイダンスについては、TypeScript の例を参照してください。

このコードは、コード レビュー プロンプトを公開するエンドポイントを作成します。

app.mcpPrompt('CodeReviewChecklist', {
    promptName: CodeReviewPromptName,
    description: CodeReviewPromptDescription,
    handler: async (_ctx: PromptInvocationContext, context: InvocationContext) => {
        context.log('Code review checklist prompt invoked.');

        return [
            "You are a senior software engineer performing a code review.",
            'Use the following checklist to evaluate the code:',
            '',
            "1. **Correctness** \u2014 Does the code do what it's supposed to?",
            '2. **Error Handling** \u2014 Are edge cases and failures handled?',
            '3. **Security** \u2014 Are there any vulnerabilities (injection, auth, secrets)?',
            '4. **Performance** \u2014 Are there obvious inefficiencies?',
            '5. **Readability** \u2014 Is the code clear and well-named?',
            '6. **Tests** \u2014 Are there adequate tests for the changes?',
            '',
            'Provide your feedback in a structured format with a severity level',
            '(critical, warning, suggestion) for each finding.',
        ].join('\n');
    },
});

このコードでは、引数を含むドキュメント生成プロンプトを公開するエンドポイントを作成します。

app.mcpPrompt('GenerateDocumentation', {
    promptName: GenerateDocsPromptName,
    description: GenerateDocsPromptDescription,
    promptArguments: {
        function_name: promptArg.describe("The function to document.").isRequired(),
        style: promptArg.describe("Documentation style (e.g., 'concise', 'verbose')."),
    },
    handler: async (ctx: PromptInvocationContext, context: InvocationContext) => {
        const functionName = ctx.arguments.function_name ?? '(unknown)';
        const style = ctx.arguments.style ?? 'concise';

        context.log(`Generate docs prompt invoked for function: ${functionName}`);

        return [
            `Generate API documentation for the function named **${functionName}**.`,
            '',
            `Documentation style: **${style}**`,
            '',
            'Include the following sections:',
            '- **Description** \u2014 What the function does.',
            '- **Parameters** \u2014 List each parameter with its type and purpose.',
            '- **Return Value** \u2014 What the function returns.',
            '- **Example Usage** \u2014 A short code example showing how to call it.',
        ].join('\n');
    },
});

完全なコード例については、GitHubの mcp-prompts サンプルを参照してください。

"extensionBundle": {
  "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
  "version": "[4.41, 5.0.0)"
}

このコードでは、 mcp_prompt_trigger デコレーターを使用してエンドポイントを作成し、 code_review_checklistという名前のプロンプトを公開します。

@app.mcp_prompt_trigger(
    arg_name="context",
    prompt_name="code_review_checklist",
    description="Returns a structured code review checklist prompt for evaluating code changes."
)
def code_review_checklist(context: func.PromptInvocationContext) -> str:
    logging.info("Code review checklist prompt invoked.")

    return """You are a senior software engineer performing a code review.
Use the following checklist to evaluate the code:

1. **Correctness** — Does the code do what it's supposed to?
2. **Error Handling** — Are edge cases and failures handled?
3. **Security** — Are there any vulnerabilities (injection, auth, secrets)?
4. **Performance** — Are there obvious inefficiencies?
5. **Readability** — Is the code clear and well-named?
6. **Tests** — Are there adequate tests for the changes?

Provide your feedback in a structured format with a severity level
(critical, warning, suggestion) for each finding."""

このコードでは、API ドキュメントを生成するための引数を含むプロンプトを公開するエンドポイントを作成します。

@app.mcp_prompt_trigger(
    arg_name="context",
    prompt_name="generate_documentation",
    prompt_arguments=[
        func.PromptArgument("function_name", "The name of the function to document.", required=False),
        func.PromptArgument("style", "Documentation style: 'concise', 'detailed', or 'tutorial'.", required=False)
    ],
    description="Generates API documentation for a function. Arguments are configured in Program.cs."
)
def generate_documentation(context: func.PromptInvocationContext) -> str:
    function_name = context.arguments.get("function_name", "(unknown)")
    style = context.arguments.get("style", "concise")

    logging.info(f"Generate docs prompt invoked for function: {function_name}")

    return f"""Generate API documentation for the function named **{function_name}**.

Documentation style: **{style}**

Include the following sections:
- **Description** — What the function does.
- **Parameters** — List each parameter with its type and purpose.
- **Return Value** — What the function returns.
- **Example Usage** — A short code example showing how to call it."""

完全なコード例については、GitHubの FunctionsMcpPrompts サンプルを参照してください。

"extensionBundle": {
  "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
  "version": "[4.41, 5.0.0)"
}

属性

C# ライブラリでは、 McpPromptTriggerAttribute を使用して関数トリガーを定義します。

この属性のコンストラクターは、次のパラメーターを受け取ります。

この属性は、次の名前付きプロパティもサポートしています。

入力パラメーターとしてプロンプトの引数を定義する方法については、「 使用法 」を参照してください。

Annotations

@McpPromptTrigger注釈を使用して、リモート MCP サーバーでプロンプト エンドポイントを公開する関数を作成します。

注釈は、次の構成オプションをサポートしています。

@McpPromptArgument注釈を使用して、個々のプロンプト引数を定義します。 関数内の各引数パラメーターにこの注釈を付けます。

@McpPromptArgument注釈では、次の構成オプションがサポートされています。

デコレータ

Python v2 プログラミング モデルにのみ適用されます。

mcp_prompt_triggerでは、次の MCP プロンプト トリガー プロパティがサポートされています。

コンフィギュレーション

コードでトリガーのバインド オプションを定義します。 次の表では、各オプションについて説明します。

完全な例については、「例」 セクションを参照してください。

MCP プロンプト トリガーは、次の種類にバインドできます。

PromptInvocationContext型には、次のプロパティがあります。

@McpPromptTrigger注釈は、プロンプト呼び出しコンテキストを JSON 文字列として含むString パラメーターにバインドされます。 トリガー関数は、 @McpPromptArgumentで注釈が付けられたパラメーターを使用して引数の値を受け取ります。

プロンプト ハンドラー関数には、次の 2 つのパラメーターがあります。

Prompt 引数

MCP クライアントは、プロンプト メッセージを生成するためのデータとコンテキストを提供するために、引数を指定してプロンプトを呼び出します。 クライアントは、プロンプトがプロトコルの一部としてアドバタイズする引数定義に基づいて、これらの引数を収集して渡す方法を知っています。 プロンプトの引数は、関数コードで定義します。

プロンプト引数を定義するときは、既定で省略可能にします。 クライアントは、プロンプトを呼び出すときに省略できます。 プロンプトなしでは操作できない場合は、引数を必須として明示的にマークします。

C# では、プロンプトの引数を複数の方法で定義できます。 どの方法を使用するかは、コード スタイルの好みの問題です。 オプションは次のとおりです。

• 関数は、 McpPromptArgument 属性を使用して入力パラメーターを受け取ります。
• FunctionsApplicationBuilderを使用して、Program.cs ファイルで引数を定義します。

var builder = FunctionsApplication.CreateBuilder(args);

builder.ConfigureFunctionsWebApplication();

builder
    .ConfigureMcpPrompt("code_review")
    .WithArgument("code", "The code to review", required: true)
    .WithArgument("language", "The programming language");

// other configuration

builder.Build().Run();

プロンプト引数は、トリガー定義の prompt_arguments フィールド ( PromptArgument オブジェクトの一覧) で構成できます。

PromptArgumentは次のように構築されます。

func.PromptArgument("argument_name", "Description of the argument", required=True)

PromptArgumentのフィールドは次のとおりです。

Javaでは、個々の関数パラメーターに対して @McpPromptArgument 注釈を使用してプロンプト引数を定義します。 この注釈を使用してプロンプト引数を表す各パラメーターに注釈を付けます。 引数の名前、説明、および必須かどうかを指定します。

これらの注釈は 、例で使用されています。

  promptArguments: {
    code: promptArg.describe("The code to review").isRequired(),
    language: promptArg.describe("The programming language"),
  }

戻り値の型

MCP プロンプト トリガーでは、次の戻り値の型がサポートされます。

MCP プロンプト トリガーでは、次の戻り値の型がサポートされます。

MCP プロンプト トリガーでは、次の戻り値の型がサポートされます。

この関数は、プロンプト メッセージ テキストを含む string を返す必要があります。 文字列は、MCP GetPromptResultで単一のユーザー ロール テキスト メッセージとしてラップされます。

プロンプトの検出

関数アプリが起動すると、すべてのプロンプト トリガー関数が MCP サーバーに登録されます。 クライアントは、MCP prompts/list メソッドを呼び出すことによって、使用可能なプロンプトを検出します。 このメソッドは、各プロンプトの名前、タイトル、説明、引数、アイコン、およびメタデータ ( meta フィールドを通じて) を返します。 クライアントは、プロンプト名と引数を使用して prompts/get を呼び出すことによってプロンプトを呼び出します。

セッション

SessionIdの PromptInvocationContext プロパティは、要求を行っている MCP セッションを識別します。 このプロパティを使用して、セッションごとの状態を維持するか、プロンプトを生成するときにセッション固有のロジックを適用します。

host.json 設定

host.json ファイルには、MCP トリガーの動作を制御する設定が含まれています。 使用可能な設定の詳細については、「host.json 設定」を参照してください。