// Copyright (c) Microsoft. All rights reserved. using MCPServer.ProjectResources; using Microsoft.SemanticKernel; using ModelContextProtocol.Protocol; using ModelContextProtocol.Server; namespace MCPServer.Tools; /// /// A collection of utility methods for working with mailbox. /// internal sealed class MailboxUtils { /// /// Summarizes unread emails in the mailbox by using MCP sampling /// mechanism for summarization. /// [KernelFunction] public static async Task SummarizeUnreadEmailsAsync([FromKernelServices] McpServer server) { if (server.ClientCapabilities?.Sampling is null) { throw new InvalidOperationException("The client does not support sampling."); } // Create two sample emails with attachments var email1 = new Email { Sender = "sales.report@example.com", Subject = "Carretera Sales Report - Jan & Jun 2014", Body = "Hi there, I hope this email finds you well! Please find attached the sales report for the first half of 2014. " + "Please review the report and provide your feedback today, if possible." + "By the way, we're having a BBQ this Saturday at my place, and you're welcome to join. Let me know if you can make it!", Attachments = [EmbeddedResource.ReadAsBytes("SalesReport2014.png")] }; var email2 = new Email { Sender = "hr.department@example.com", Subject = "Employee Birthdays and Positions", Body = "Attached is the list of employee birthdays and their positions. Please check it and let me know of any updates by tomorrow." + "Also, we're planning a hike this Sunday morning. It would be great if you could join us. Let me know if you're interested!", Attachments = [EmbeddedResource.ReadAsBytes("EmployeeBirthdaysAndPositions.png")] }; CreateMessageRequestParams request = new() { SystemPrompt = "You are a helpful assistant. You will be provided with a list of emails. Please summarize them. Each email is followed by its attachments.", Messages = CreateMessagesFromEmails(email1, email2), Temperature = 0 }; // Send the sampling request to the client to summarize the emails CreateMessageResult result = await server.SampleAsync(request, cancellationToken: CancellationToken.None); // Assuming the response is a text message return (result.Content as TextContentBlock)!.Text; } /// /// Creates a list of SamplingMessage objects from a list of emails. /// /// The list of emails. /// A list of SamplingMessage objects. private static List CreateMessagesFromEmails(params Email[] emails) { var messages = new List(); foreach (var email in emails) { messages.Add(new SamplingMessage { Role = Role.User, Content = new TextContentBlock { Text = $"Email from {email.Sender} with subject {email.Subject}. Body: {email.Body}", } }); if (email.Attachments != null && email.Attachments.Count != 0) { foreach (var attachment in email.Attachments) { messages.Add(new SamplingMessage { Role = Role.User, Content = new ImageContentBlock { Data = Convert.ToBase64String(attachment), MimeType = "image/png", } }); } } } return messages; } /// /// Represents an email. /// private sealed class Email { /// /// Gets or sets the email sender. /// public required string Sender { get; set; } /// /// Gets or sets the email subject. /// public required string Subject { get; set; } /// /// Gets or sets the email body. /// public required string Body { get; set; } /// /// Gets or sets the email attachments. /// public List? Attachments { get; set; } } }