Протокол контекста модели

Эта страница переведена с английского автоматически. Читать оригинал

Можно создавать приложения, которые предоставляют контекст моделям‑агентам, использующим большие языковые модели (LLM), с помощью пакета Sisk.ModelContextProtocol :

dotnet add package Sisk.ModelContextProtocol --prerelease

Этот пакет предоставляет полезные классы и методы для построения MCP‑серверов, работающих по протоколу Streamable HTTP, поддерживая одиночные запрос‑ответ сообщения. Начиная с версии 1.7.0‑rc1 он поддерживает безсостояние запросов версии протокола 2026-07-28 и сохраняет устаревший процесс инициализации для клиентов, использующих версии 2025-11-25, 2025-06-18 и 2025-03-26. Поддерживаются инструменты и навыки.

Примечание

Прежде чем начать, обратите внимание, что этот пакет находится в разработке и может вести себя не в соответствии со спецификацией. Прочитайте подробности пакета, чтобы узнать, что уже реализовано, а что ещё не работает.

Начало работы с MCP #

Класс McpProvider является точкой входа для определения MCP‑сервера. Это запечатлённый объект‑провайдер, который можно настроить при запуске. Ваше приложение Sisk может иметь один или несколько MCP‑провайдеров.

McpProvider mcp = new McpProvider(
    serverName: "math-server",
    serverTitle: "Mathematics server",
    serverVersion: new Version(1, 0));

mcp.Tools.Add(new McpTool(
    name: "math_sum",
    description: "Sums one or more numbers.",
    schema: JsonSchema.CreateObjectSchema(
        properties: new Dictionary<string, JsonSchema>()
        {
            { "numbers",
                JsonSchema.CreateArraySchema(
                    itemsSchema: JsonSchema.CreateNumberSchema(),
                    minItems: 1,
                    description: "The numbers to sum.")
            }
        },
        requiredProperties: ["numbers"]),
    executionHandler: async (McpToolContext context) =>
    {
        var numbers = context.Arguments["numbers"].GetJsonArray().ToArray<double>();
        var sum = numbers.Sum();
        return await Task.FromResult(McpToolResult.CreateText($"Sum result: {sum:N4}"));
    }));

Если ваше приложение будет предоставлять только один MCP‑провайдер, можно воспользоваться синглтоном билдера:

static void Main(string[] args)
{
    using var host = HttpServer.CreateBuilder()
        .UseMcp(mcp =>
        {
            mcp.ServerName = "math-server";
            mcp.ServerTitle = "Mathematics server";

            mcp.Tools.Add(new McpTool(
                name: "math_sum",
                description: "Sums one or more numbers.",
                schema: JsonSchema.CreateObjectSchema(
                    properties: new Dictionary<string, JsonSchema>()
                    {
                        { "numbers",
                            JsonSchema.CreateArraySchema(
                                itemsSchema: JsonSchema.CreateNumberSchema(),
                                minItems: 1,
                                description: "The numbers to sum.")
                        }
                    },
                    requiredProperties: ["numbers"]),
                executionHandler: async (McpToolContext context) =>
                {
                    var numbers = context.Arguments["numbers"].GetJsonArray().ToArray<double>();
                    var sum = numbers.Sum();
                    return await Task.FromResult(McpToolResult.CreateText($"Sum result: {sum:N4}"));
                }));
        })
        .UseRouter(router =>
        {
            router.MapAny("/mcp", async (HttpRequest req) =>
            {
                return await req.HandleMcpRequestAsync();
            });
        })
        .Build();

    host.Start();
}

Точка доступа должна принимать как GET, так и POST запросы, поэтому MapAny — самое простое сопоставление маршрута. HandleMcpRequestAsync возвращает HttpResponse, и ваш маршрут должен вернуть его. Если нужны несколько провайдеров в одном приложении, пропустите синглтон и вызывайте McpProvider.HandleRequestAsync напрямую из каждого маршрута:

var mathProvider = new McpProvider("math-server", "Mathematics server", new Version(1, 0));

router.MapAny("/mcp/math", async request =>
{
    return await mathProvider.HandleRequestAsync(request);
});

Создание JSON‑схем для функций #

Библиотека [Sisk.ModelContextProtocol] использует форк LightJson для работы с JSON и JSON‑схемами. Эта реализация предоставляет удобный построитель JSON‑Schema для различных объектов:

JsonSchema.CreateObjectSchema
JsonSchema.CreateArraySchema
JsonSchema.CreateBooleanSchema
JsonSchema.CreateNumberSchema
JsonSchema.CreateStringSchema
JsonSchema.Empty

Пример:

JsonSchema.CreateObjectSchema(
    properties: new Dictionary<string, JsonSchema>()
    {
        { "numbers",
            JsonSchema.CreateArraySchema(
                itemsSchema: JsonSchema.CreateNumberSchema(),
                minItems: 1,
                description: "The numbers to sum.")
        }
    },
    requiredProperties: ["numbers"]);

Создаёт следующую схему:

JSON

{
  "type": "object",
  "properties": {
    "numbers": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "minItems": 1,
      "description": "The numbers to sum."
    }
  },
  "required": ["numbers"]
}

Обработка вызовов функций #

Функция, определённая в параметре executionHandler класса McpTool, предоставляет JsonObject, содержащий аргументы вызова, которые можно удобно читать:

mcp.Tools.Add(new McpTool(
    name: "browser_do_action",
    description: "Run an browser action, such as scrolling, refreshing or navigating.",
    schema: JsonSchema.CreateObjectSchema(
        properties: new Dictionary<string, JsonSchema>()
        {
            { "action_name",
                JsonSchema.CreateStringSchema(
                    enums: ["go_back", "refresh", "scroll_bottom", "scroll_top"],
                    description: "The action name.")
            },
            { "action_data",
                JsonSchema.CreateStringSchema(
                    description: "Action parameter."
                ) }
        },
        requiredProperties: ["action_name"]),
    executionHandler: async (McpToolContext context) =>
    {
        // читаем имя действия. будет выброшено исключение, если значение null или не является строкой
        string actionName = context.Arguments["action_name"].GetString();
        
        // action_data объявлен как необязательный, поэтому здесь может быть null
        string? actionData = context.Arguments["action_data"].MaybeNull()?.GetString();
        
        // Обрабатываем действие браузера на основе actionName
        return await Task.FromResult(
            McpToolResult.CreateText($"Performed browser action: {actionName}"));
    }));

Аргументы инструмента проверяются по схеме до выполнения вашего обработчика. Если проверка не проходит, провайдер возвращает клиенту MCP ошибку и не вызывает обработчик инструмента.

Результаты функций #

Объект McpToolResult предоставляет три метода для создания содержимого ответа инструмента:

CreateAudio(ReadOnlySpan, string): создаёт аудио‑ответ для клиента MCP.
CreateImage(ReadOnlySpan, string): создаёт изображение‑ответ для клиента MCP.
CreateText(string): создаёт текстовый ответ (по умолчанию) для клиента MCP.

Кроме того, можно объединить несколько разных типов содержимого в один JSON‑ответ инструмента:

mcp.Tools.Add(new McpTool(
    ...
    executionHandler: async (McpToolContext context) =>
    {
        // simulate real work

        byte[] browserScreenshot = await browser.ScreenshotAsync();
        
        return McpToolResult.Combine(
            McpToolResult.CreateText("Heres the screenshot of the browser:"),
            McpToolResult.CreateImage(browserScreenshot, "image/png")
        )
    }));

В данный момент провайдер обрабатывает методы server/discover, устаревшие initialize и ping, tools/list, tools/call, skills/list, skills/get, resources/list, resources/read и уведомления. Неподдерживаемые методы JSON‑RPC возвращают ошибку JSON‑RPC.

Публикация навыков #

MCP‑провайдер также может публиковать Agent Skills через расширение io.modelcontextprotocol/skills. Добавьте объекты McpSkill в McpProvider.Skills до того, как провайдер начнёт обрабатывать запросы:

mcp.Skills.Add(new McpSkill(
    path: "acme/refunds",
    frontmatter: new JsonObject
    {
        ["name"] = "refunds",
        ["description"] = "Follow the refund workflow."
    },
    body: "# Refunds\nRead references/policy.md before using the refund tools.",
    files: new Dictionary<string, byte[]>
    {
        ["references/policy.md"] = File.ReadAllBytes("skills/refunds/references/policy.md")
    }));

McpSkill генерирует файл SKILL.md из frontmatter и тела Markdown. Последний сегмент path должен совпадать с полем name в frontmatter. Файлы навыка копируются при его создании и больше не читаются с диска провайдером. Клиенты получают список и читают навыки через skills/list, skills/get и resources/read, используя версию протокола 2026-07-28. См. подробности пакета для ограничений и правил валидации.

Дальнейшая работа #

Протокол контекста модели — это коммуникационный протокол для моделей‑агентов и приложений, предоставляющих им контент. Это новый протокол, поэтому его спецификация часто обновляется: появляются устаревания, новые возможности и несовместимые изменения.

Важно понять, какие задачи решает Model Context Protocol, прежде чем начинать создавать агентные приложения.

Также ознакомьтесь со спецификацией пакета Sisk.ModelContextProtocol, чтобы понять его текущее состояние, прогресс и возможности использования.