Mpc Csharp Semantickernel

🚀 mpc-csharp-semantickernel

This is an example of implementing the Model Context Protocol using Microsoft Semantic Kernel, OpenAI, and the official C# SDK. You can refer to the official repository for the protocol: https://github.com/modelcontextprotocol/csharp-sdk

🚀 Quick Start

✨ Features

This project demonstrates how to use Microsoft Semantic Kernel and OpenAI to implement the Model Context Protocol, with functions like sending emails through the EmailTools feature.

📦 Installation

Prerequisites

• SMTP mail server (for the EmailTools feature)
• OpenAI API key

Steps to Run the Example Project

1. Obtain an API key from the OpenAI developer dashboard.
2. Fill in the appsettings configuration information for each project.
3. There is a hard - coded email address dictionary in the Tools/EmailTool.cs file for sending emails. Please update the email address list in this dictionary. It is recommended to change it to configuration settings.
4. Run the project. The default startup address is http://localhost:5109

Configuration Instructions

WebAppMCPPoc Project

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "OpenAI": {
    "ApiKey": "<yourApiKey>",
    "ChatModelId" : "gpt-4o-mini"
  }
}

MCPServer Project

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "EmailSettings": {
    "SMTPServer": {
      "MailPort": "465",
      "MailServer": "<yourserver.com>",
      "Sender": "<sender@youremail.com>",
      "SenderName": "<AIEmailSender>",
      "Password": "<EmailPassword>",
      "Username": "<EmailUsername>"
    }
  }
}

💻 Usage Examples

Basic Usage

You can use tools like Postman to send requests.

Example request: POST https://localhost:7113/chat Body content: { "text": "Send an email to aFriend, telling him that you are an AI and explain in 250 words how you implemented it using C#."}

Replace "aFriend" with a name added in the emails dictionary in the EmailTool class.

        private static readonly Dictionary<string, string> emails = new Dictionary<string, string>
        {
            { "example", "mail@example.com" },
            { "aFriend", "friendEmail@gmail.com" }
        };

📄 License

This project uses the MIT license.