Azure Functions 대한 MCP 리소스 트리거

이 첫 번째 예제에서는 리소스를 사용하여 MCP 앱의 UI 요소를 구현하는 방법을 보여줍니다.

다음 코드는 대화형 날씨 표시를 번들 HTML 콘텐츠로 제공하는 리소스 Weather Widget 를 노출하는 엔드포인트를 만듭니다. 리소스는 이 체계를 ui:// 사용하여 MCP 앱 UI 리소스임을 나타냅니다.

// Optional resource metadata
private const string ResourceMetadata = """
    {
        "ui": {
            "prefersBorder": true
        }
    }
    """;

[Function(nameof(GetWeatherWidget))]
public string GetWeatherWidget(
    [McpResourceTrigger(
        "ui://weather/index.html",
        "Weather Widget",
        MimeType = "text/html;profile=mcp-app",
        Description = "Interactive weather display for MCP Apps")]
    [McpMetadata(ResourceMetadata)]
        ResourceInvocationContext context)
{
    var file = Path.Combine(AppContext.BaseDirectory, "app", "dist", "index.html");
    return File.ReadAllText(file);
}

도구는 메타데이터에서 이 리소스를 resourceUri 가리키도록 선언하여 이 리소스를 참조할 수 있습니다 ui://weather/index.html. 도구를 호출하면 MCP 호스트가 리소스를 가져와서 렌더링합니다.

private const string ToolMetadata = """
    {
        "ui": {
            "resourceUri": "ui://weather/index.html"
        }
    }
    """;

[Function(nameof(GetWeather))]
public async Task<object> GetWeather(
    [McpToolTrigger(nameof(GetWeather), "Returns current weather for a location via Open-Meteo.")]
    [McpMetadata(ToolMetadata)]
        ToolInvocationContext context,
    [McpToolProperty("location", "City name to check weather for (e.g., Seattle, New York, Miami)")]
        string location)
{
    var result = await _weatherService.GetCurrentWeatherAsync(location);
    return result;
}

전체 코드 예제는 WeatherFunction.cs 참조하세요.

이 코드 예제에서는 markdown 파일을 읽고 해당 내용을 일반 텍스트로 반환하는 리소스 readme 를 노출하는 엔드포인트를 만듭니다. 클라이언트는 URI를 사용하여 이 리소스에 file://readme.md 액세스할 수 있습니다.

    private const string ReadmeMetadata = """
        {
            "author": "John Doe",
            "file": {
                "version": 1.0,
                "releaseDate": "2024-01-01"
            },
            "test": {
                "example": ["list", "of", "values"]
            }
        }
        """;

    [Function(nameof(GetTextResource))]
    public string GetTextResource(
        [McpResourceTrigger(
            "file://readme.md",
            "readme",
            Description = "Application readme file",
            MimeType = "text/plain")]
        [McpMetadata(ReadmeMetadata)]
        ResourceInvocationContext context)
    {
        _logger.LogInformation("Reading text resource from local file storage");
        var file = Path.Combine(AppContext.BaseDirectory, "assets", "readme.md");
        return File.ReadAllText(file);
    }

이 예제에서는 다음 지시문이 파일에 있으므로 이 폴더를 assets 포함하는 폴더 readme 가 .csproj 빌드 시 함수 앱과 함께 번들로 제공됩니다.

<ItemGroup>
  <None Update="assets\**\*">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
</ItemGroup>

전체 코드 예제는 Azure Functions MCP 확장 리포지토리 참조하세요.

JavaScript에 대한 예제 코드는 현재 사용할 수 없습니다. 일반적인 지침은 TypeScript 예제를 참조하세요.

아래 코드는 대화형 날씨 표시를 번들 HTML 콘텐츠로 제공하는 리소스를 Weather Widget 등록합니다. 리소스는 이 체계를 ui:// 사용하여 MCP 앱 UI 리소스임을 나타냅니다.

// Constants for the Weather Widget resource
const WEATHER_WIDGET_URI = "ui://weather/index.html";
const WEATHER_WIDGET_NAME = "Weather Widget";
const WEATHER_WIDGET_DESCRIPTION = "Interactive weather display for MCP Apps";
const WEATHER_WIDGET_MIME_TYPE = "text/html;profile=mcp-app";

// Metadata for the resource 
const RESOURCE_METADATA = JSON.stringify({
  ui: {
    prefersBorder: true
  }
});

app.mcpResource("getWeatherWidget", {
  uri: WEATHER_WIDGET_URI,
  resourceName: WEATHER_WIDGET_NAME,
  description: WEATHER_WIDGET_DESCRIPTION,
  mimeType: WEATHER_WIDGET_MIME_TYPE,
  metadata: RESOURCE_METADATA,
  handler: getWeatherWidget,
});

다음 코드는 처리기입니다 getWeatherWidget .

export async function getWeatherWidget(
  resourceContext: unknown,
  context: InvocationContext
): Promise<string> {
  context.log("Getting weather widget");

  try {
    const filePath = path.join(__dirname, "..", "..", "..", "src", "app", "dist", "index.html");
    return fs.readFileSync(filePath, "utf-8");
  } catch (error) {
    context.log(`Error reading weather widget file: ${error}`);
    return `<!DOCTYPE html>
      <html>
      <head><title>Weather Widget</title></head>
      <body>
      <h1>Weather Widget</h1>
      <p>Widget content not found. Please ensure the app/dist/index.html file exists.</p>
      </body>
      </html>`;
  }
}

도구는 메타데이터에서 선언하여 이 리소스를 resourceUri 참조할 수 있습니다. 도구를 호출하면 MCP 호스트가 리소스를 가져와서 렌더링합니다.

// Metadata for the tool (as valid JSON string)
const TOOL_METADATA = JSON.stringify({
  ui: {
    resourceUri: "ui://weather/index.html"
  }
});

app.mcpTool("getWeather", {
  toolName: "GetWeather",
  description: "Returns current weather for a location via Open-Meteo.",
  toolProperties: {
    location: arg.string().describe("City name to check weather for (e.g., Seattle, New York, Miami)")
  },
  metadata: TOOL_METADATA,
  handler: getWeather,
});

전체 코드 예제는 weatherMcpApp.ts 참조하세요.

다음 코드는 대화형 날씨 표시를 번들 HTML 콘텐츠로 제공하는 리소스 Weather Widget 를 등록합니다. 리소스는 이 체계를 ui:// 사용하여 MCP 앱 UI 리소스임을 나타냅니다.

# Constants for the Weather Widget resource
WEATHER_WIDGET_URI = "ui://weather/index.html"
WEATHER_WIDGET_NAME = "Weather Widget"
WEATHER_WIDGET_DESCRIPTION = "Interactive weather display for MCP Apps"
WEATHER_WIDGET_MIME_TYPE = "text/html;profile=mcp-app"

# Metadata for the resource 
RESOURCE_METADATA = '{"ui": {"prefersBorder": true}}'

@app.mcp_resource_trigger(
    arg_name="context",
    uri=WEATHER_WIDGET_URI,
    resource_name=WEATHER_WIDGET_NAME,
    description=WEATHER_WIDGET_DESCRIPTION,
    mime_type=WEATHER_WIDGET_MIME_TYPE,
    metadata=RESOURCE_METADATA
)
def get_weather_widget(context) -> str:
    """Get the weather widget HTML content."""
    logging.info("Getting weather widget")

    current_dir = Path(__file__).parent
    file_path = current_dir / "app" / "dist" / "index.html"

    if file_path.exists():
        return file_path.read_text(encoding="utf-8")
    else:
        logging.warning(f"Weather widget file not found at: {file_path}")
        return """<!DOCTYPE html>
        <html>
        <head><title>Weather Widget</title></head>
        <body>
        <h1>Weather Widget</h1>
        <p>Widget content not found. Please ensure the app/index.html file exists.</p>
        </body>
        </html>"""

도구는 메타데이터에서 이 리소스를 resourceUri 가리키도록 선언하여 이 리소스를 참조할 수 있습니다 ui://weather/index.html. 도구를 호출하면 MCP 호스트가 리소스를 가져와서 렌더링합니다.

# Metadata for the tool
TOOL_METADATA = '{"ui": {"resourceUri": "ui://weather/index.html"}}'

@app.mcp_tool(metadata=TOOL_METADATA)
@app.mcp_tool_property(arg_name="location", description="City name to check weather for (e.g., Seattle, New York, Miami)")
def get_weather(location: str) -> Dict[str, Any]:
    """Returns current weather for a location via Open-Meteo."""
    logging.info(f"Getting weather for location: {location}")

    result = weather_service.get_current_weather(location)
    return json.dumps(result)

전체 코드 예제는 function_app.py 참조하세요.

다음 코드는 대화형 날씨 표시를 번들 HTML 콘텐츠로 제공하는 리소스 Weather Widget 를 등록합니다. 리소스는 이 체계를 ui:// 사용하여 MCP 앱 UI 리소스임을 나타냅니다.

private static final String RESOURCE_METADATA = """
        {
            "ui": {
                "prefersBorder": true
            }
        }
        """;

@FunctionName("GetWeatherWidget")
public String getWeatherWidget(
        @McpResourceTrigger(
                name = "context",
                uri = "ui://weather/index.html",
                resourceName = "Weather Widget",
                title = "Weather Widget",
                description = "Interactive weather display for MCP Apps",
                mimeType = "text/html;profile=mcp-app")
        @McpMetadata(
                name = "context",
                json = RESOURCE_METADATA)
        String context,
        final ExecutionContext executionContext) {

    executionContext.getLogger().info("GetWeatherWidget: serving weather widget UI");

    return java.nio.file.Files.readString(file.toPath(), StandardCharsets.UTF_8);
}

도구는 메타데이터에서 이 리소스를 resourceUri 가리키도록 선언하여 이 리소스를 참조할 수 있습니다 ui://weather/index.html. 도구를 호출하면 MCP 호스트가 리소스를 가져와서 렌더링합니다.

private static final String TOOL_METADATA = """
        {
            "ui": {
                "resourceUri": "ui://weather/index.html"
            }
        }
        """;

@FunctionName("GetWeather")
public String getWeather(
        @McpToolTrigger(
                name = "GetWeather",
                description = "Returns current weather for a location via Open-Meteo.")
        @McpMetadata(
                name = "GetWeather",
                json = TOOL_METADATA)
        String context,
        @McpToolProperty(
                name = "location",
                propertyType = "string",
                description = "City name to check weather for (e.g., Seattle, New York, Miami)")
        String location,
        final ExecutionContext executionContext) {

    executionContext.getLogger().info("GetWeather: looking up weather for '" + location + "'");

    Object result = weatherService.getCurrentWeather(location);

    return MAPPER.writeValueAsString(result);
}

전체 코드 예제는 WeatherFunction.java 참조하세요.

특성

C# 라이브러리는 함수 트리거를 정의하는 데 사용합니다 McpResourceTriggerAttribute .

특성의 생성자는 다음 매개 변수를 사용합니다.

이 특성은 다음과 같은 명명된 속성도 지원합니다.

특성을 사용하여 리소스에 [McpMetadata] 대한 더 많은 메타데이터를 제공할 수 있습니다. 이 메타데이터는 클라이언트가 호출 resources/list할 때 각 리소스의 메타 필드에 포함되며 리소스 콘텐츠가 표시되거나 처리되는 방식에 영향을 줄 수 있습니다.

리소스 트리거가 함수에 데이터를 제공하는 방법을 알아보려면 사용량을 참조하세요.

데코레이터

다음 MCP 리소스 트리거 속성은 다음에서 지원됩니다.mcp_resource_trigger

구성 / 설정

코드에서 트리거의 바인딩 옵션을 정의합니다. 트리거는 다음 옵션을 지원합니다.

특성

함수 매개 변수에 @McpResourceTrigger 주석을 적용하여 MCP 리소스 트리거를 정의합니다.

주석은 @McpResourceTrigger 다음 속성을 지원합니다.

메타데이터 주석

필요에 따라 리소스에 임의의 JSON 메타데이터를 연결하는 것과 @McpMetadata 동일한 매개 변수에 적용 @McpResourceTrigger 할 수 있습니다. 이 메타데이터는 클라이언트가 호출_meta할 때 MCP 프로토콜의 resources/list 필드에 표시됩니다.

주석은 @McpMetadata 다음 속성을 지원합니다.

Example:

@McpResourceTrigger(
        name = "context",
        uri = "file://readme.md",
        resourceName = "readme",
        description = "Application readme file",
        mimeType = "text/plain")
@McpMetadata(
        name = "context",
        json = "{\"author\": \"John Doe\", \"version\": 1.0}")

전체 예제는 예제 섹션을 참조하세요.

Usage

MCP 리소스 트리거는 다음 형식에 바인딩할 수 있습니다.

이 형식은 ResourceInvocationContext 다음 속성을 제공합니다.

데코레이터는 mcp_resource_trigger MCP 클라이언트의 리소스 요청을 나타내는 컨텍스트 매개 변수에 바인딩됩니다. 트리거는 다음 형식에 바인딩할 수 있습니다. strdictbytes

리소스 처리기 함수에는 두 개의 매개 변수가 있습니다.

MCP 리소스 트리거는 리소스 호출 컨텍스트를 함수 매개 변수에 바인딩합니다. 트리거는 다음 형식 Stringbyte[] 또는 이진 콘텐츠에 바인딩할 수 있습니다.

리소스 URI

MCP 리소스는 URI를 사용하여 리소스의 주소를 정의합니다. URI는 리소스를 고유하게 식별하고 클라이언트가 리소스를 요청하는 데 사용하는 것입니다. UI 리소스 또는 ui:// 파일 기반 리소스와 같이 file:// 리소스에 적합한 URI 체계를 사용할 수 있습니다.

리소스 메타데이터

McpMetadata 특성을 사용하여 리소스에 대한 추가 메타데이터를 제공합니다. MCP 클라이언트는 이 메타데이터를 수신하며 리소스 콘텐츠가 표시되거나 처리되는 방식에 영향을 줄 수 있습니다.

리소스에 대한 추가 메타데이터를 제공하려면 데코레이터에서 metadata 매개 변수를 mcp_resource_trigger 사용합니다. 이 메타데이터는 클라이언트가 호출meta할 때 각 리소스의 필드에 포함된 resources/list JSON 직렬화된 문자열입니다. 리소스 콘텐츠가 표시되거나 처리되는 방식에 영향을 줄 수 있습니다.

이 metadata 옵션을 사용하여 리소스에 대한 추가 메타데이터를 제공합니다. 이 메타데이터는 클라이언트가 호출meta할 때 각 리소스의 필드에 포함된 resources/list JSON 직렬화된 문자열입니다. 리소스 콘텐츠가 표시되거나 처리되는 방식에 영향을 줄 수 있습니다.

주석을 @McpMetadata 사용하여 리소스에 대한 추가 메타데이터를 제공합니다. 이 메타데이터는 클라이언트가 호출meta할 때 각 리소스의 필드에 포함된 resources/list JSON 직렬화된 문자열입니다. 리소스 콘텐츠가 표시되거나 처리되는 방식에 영향을 줄 수 있습니다.

반환 형식

MCP 리소스 트리거는 다음 반환 형식을 지원합니다.

MCP 리소스 트리거는 다음 반환 형식을 지원합니다.

함수는 리소스 콘텐츠(예: HTML, JSON 또는 일반 텍스트)를 포함하는 값을 반환 string 해야 합니다.

MCP 리소스 트리거는 다음 반환 형식을 지원합니다.

리소스 검색

함수 앱이 시작되면 모든 리소스 트리거 함수를 MCP 서버에 등록합니다. 클라이언트는 MCP resources/list 메서드를 호출하여 사용 가능한 리소스를 검색합니다. 이 메서드는 각 리소스의 URI, 이름, 설명, MIME 형식, 크기 및 메타데이터(필드를 통해 meta )를 반환합니다. 클라이언트는 리소스 URI를 사용하여 호출 resources/read 하여 리소스를 읽습니다.

Sessions

온 SessionId 속성은 ResourceInvocationContext 요청을 만드는 MCP 세션을 식별합니다. 이 속성을 사용 하 여 세션별 상태를 유지 관리 하거나 리소스를 제공 하는 경우 세션별 논리를 적용 합니다.

자세한 내용은 예제참조하세요.

host.json 설정

host.json 파일에는 MCP 트리거 동작을 제어하는 설정이 포함되어 있습니다. 사용 가능한 설정에 대한 자세한 내용은 host.json 설정 섹션을 참조하세요.