🛠 MCP C# SDK v1.0

Стабильная версия пакета разработчика принесла полезные фичи для интеграции ИИ в .NET.

OAuth теперь проще. Сервер может хранить метаданные тремя способами, пакет найдёт сам.

Инструменты теперь получают иконки. Настраивается через атрибут:

[McpServerTool(IconSource = "https://example.com/icon.svg")]
public static string GetWeather(string city) { }

Инструменты в запросах к модели

Сервер может включить инструменты в запрос к модели языка, и она их вызовет. Модель выполняет инструмент, сервер обрабатывает результат и отправляет обратно. Это может повторяться несколько раз.

На клиенте объявляйте поддержку:

var mcpClient = await McpClient.CreateAsync(
    new HttpClientTransport(new() { Endpoint = new Uri("http://localhost:6184") }),
    clientOptions: new()
    {
        Capabilities = new ClientCapabilities
        {
            Sampling = new SamplingCapability { Tools = new SamplingToolsCapability {} }
        }
    });

На сервере просто передавайте инструменты в запрос:

Tool rollDieTool = new Tool()
{
    Name = "roll_die",
    Description = "Rolls a six-sided die and returns 1-6."
};

Долгоживущие запросы

Раньше при разрыве соединения нужно было пересоединяться. Теперь сервер отправляет пустое событие с ID и может закрыть соединение. Клиент переподключится через этот ID.

На сервере:

builder.Services.AddDistributedMemoryCache();
builder.Services.AddMcpServer()
    .WithHttpTransport()
    .WithDistributedCacheEventStreamStore()
    .WithTools<MyTools>();

В обработчик вызовите:

await context.EnablePollingAsync(retryInterval: TimeSpan.FromSeconds(5));

Задачи для долгих операций

Задачи хранят результаты надёжно и позволяют опрашивать состояние, получать результаты и отменять работу. Могут быть в состояниях: работает, требуется ввод, завершена, ошибка, отменена.

На сервере:

var taskStore = new InMemoryMcpTaskStore();
builder.Services.AddMcpServer(options => { options.TaskStore = taskStore; })
    .WithHttpTransport();

Инструменты автоматически поддерживают задачи если возвращают Task:

[McpServerTool(TaskSupport = ToolTaskSupport.Required)]
public static async Task<string> ProcessData(int count, CancellationToken ct)
{
    await Task.Delay(TimeSpan.FromSeconds(8), ct);
    return $"Processed {count} records.";
}

На клиенте:

var result = await client.CallToolAsync(
    new CallToolRequestParams
    {
        Name = "processDataset",
        Task = new McpTaskMetadata { TimeToLive = TimeSpan.FromHours(2) }
    });

var completedTask = await client.PollTaskUntilCompleteAsync(result.Task.TaskId);

Версия 1.0 это полноценная платформа для ИИ интеграции в .NET.

📍 Навигация: Вакансии • Задачи • Собесы

🐸 Библиотека шарписта

#async_news