trackmcp
Back to directory
StefH

mcpdotnet.extensions.semantickernel

View on GitHub

Microsoft SemanticKernel integration for the Model Context Protocol (MCP). Enables seamless use of MCP tools as AI functions.

34 stars C#AI & Machine Learning Updated Oct 31, 2025

Documentation

!Project Icon ModelContextProtocol.SemanticKernel

Microsoft SemanticKernel integration for the Model Context Protocol using the csharp-sdk.

Enables seamless use of MCP tools as AI functions.

> [!NOTE]

> This project is in preview; breaking changes can be introduced without prior notice.

πŸ“¦ NuGet packages

Stef.ModelContextProtocol.SemanticKernel![NuGet Badge](https://www.nuget.org/packages/Stef.ModelContextProtocol.SemanticKernel)
Stef.ModelContextProtocol.Schema![NuGet Badge](https://www.nuget.org/packages/Stef.ModelContextProtocol.Schema)

Overview

mermaid
---
title: "Overview"
---

graph LR;
    SK[Semantic Kernel'OpenAI'] 
    MCPClient[MCPClient'Function Calling']
    MCPServer[Local MCP Server'server-github'] 
    GitHub[GitHub]

    SK  MCPClient
    MCPClient  MCPServer
    MCPServer  GitHub

βš™οΈ Usage

Use an extension method to register a specific MCP function/tool

Register single function or tool

csharp
// πŸ’‘Stdio
await kernel.Plugins.AddMcpFunctionsFromStdioServerAsync("GitHub", "npx", ["-y", "@modelcontextprotocol/server-github"]);

// πŸ’‘SSE
await kernel.Plugins.AddMcpFunctionsFromSseServerAsync("GitHub", new Uri("http://localhost:12345"));

Register MCP Server(s) from Claude Desktop configuration

It's also possible to register all Stdio MCP Servers which are registered in Claude Desktop:

csharp
// πŸ’‘Stdio MCP Tools defined in claude_desktop_config.json
await kernel.Plugins.AddToolsFromClaudeDesktopConfigAsync(cancellationToken: cts.Token);

πŸ’» Full Stdio Example

Code

csharp
var builder = Kernel.CreateBuilder();
builder.Services.AddLogging(c => c.AddDebug().SetMinimumLevel(LogLevel.Trace));

builder.Services.AddOpenAIChatCompletion(
    serviceId: "openai",
    modelId: "gpt-4o-mini",
    apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY")!);

var kernel = builder.Build();

// πŸ’‘ Add this line to enable MCP functions from a Stdio server named "Everything"
await kernel.Plugins.AddMcpFunctionsFromStdioServerAsync("Everything", "npx", ["-y", "@modelcontextprotocol/server-github"]);

var executionSettings = new OpenAIPromptExecutionSettings
{
    Temperature = 0,
    FunctionChoiceBehavior = FunctionChoiceBehavior.Auto()
};

var prompt = "Please call the echo tool with the string 'Hello Stef!' and give me the response as-is.";
var result = await kernel.InvokePromptAsync(prompt, new(executionSettings)).ConfigureAwait(false);
Console.WriteLine($"\n\n{prompt}\n{result}");

Result

code
Please call the echo tool with the string 'Hello Stef!' and give me the response as-is.
Echo: Hello Stef!

πŸ’» Full SSE (Server-Sent Events) Example

Code

csharp
var builder = Kernel.CreateBuilder();
builder.Services.AddLogging(c => c.AddDebug().SetMinimumLevel(LogLevel.Trace));

builder.Services.AddOpenAIChatCompletion(
    serviceId: "openai",
    modelId: "gpt-4o-mini",
    apiKey: Environment.GetEnvironmentVariable("OPENAI_API_KEY")!);

var kernel = builder.Build();

// πŸ’‘ Add this line to enable MCP functions from a Sse server named "Github"
// - Note that a server must be running at the specified URL
await kernel.Plugins.AddMcpFunctionsFromSseServerAsync("GitHub", "http://localhost:12345");

var executionSettings = new OpenAIPromptExecutionSettings
{
    Temperature = 0,
    FunctionChoiceBehavior = FunctionChoiceBehavior.Auto()
};

var prompt = "Summarize the last 3 commits to the StefH/FluentBuilder repository.";
var result = await kernel.InvokePromptAsync(prompt, new(executionSettings)).ConfigureAwait(false);
Console.WriteLine($"\n\n{prompt}\n{result}");

Result

code
Summarize the last 3 commits to the StefH/FluentBuilder repository.
Here are the summaries of the last three commits to the `StefH/FluentBuilder` repository:

1. **Commit [2293880](https://github.com/StefH/FluentBuilder/commit/229388090f50a39f489e30cb535f67f3705cf61f)** (January 30, 2025)
   - **Author:** Stef Heyenrath
   - **Message:** Update README.md
   - **Details:** This commit updates the README.md file. The commit was verified and is valid.

2. **Commit [ae27064](https://github.com/StefH/FluentBuilder/commit/ae2706424c3b75613bf5625091aa2649fb33ecde)** (November 6, 2024)
   - **Author:** Stef Heyenrath
   - **Message:** Update README.md
   - **Details:** This commit also updates the README.md file. The commit was verified and is valid.

3. **Commit [53096a8](https://github.com/StefH/FluentBuilder/commit/53096a8b54a1029532425bc727fdd831e9ed0092)** (October 20, 2024)
   - **Author:** Stef Heyenrath
   - **Message:** Update README.md
   - **Details:** This commit updates the README.md file as well. The commit was verified and is valid.

All three commits involve updates to the README.md file, reflecting ongoing improvements or changes to the documentation.

πŸ“– References

  • https://modelcontextprotocol.io
  • https://github.com/PederHP/mcpdotnet
  • https://github.com/modelcontextprotocol/csharp-sdk
  • https://devblogs.microsoft.com/semantic-kernel/integrating-model-context-protocol-tools-with-semantic-kernel-a-step-by-step-guide/

Sponsors

Entity Framework Extensions and Dapper Plus are major sponsors and proud to contribute to the development of ModelContextProtocol-SemanticKernel.

Entity Framework Extensions
Dapper Plus

Frequently asked questions

What is mcpdotnet.extensions.semantickernel?

mcpdotnet.extensions.semantickernel is Microsoft SemanticKernel integration for the Model Context Protocol (MCP). Enables seamless use of MCP tools as AI functions.

How do I install mcpdotnet.extensions.semantickernel?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is mcpdotnet.extensions.semantickernel open source?

Yes β€” it is hosted on GitHub at https://github.com/StefH/McpDotNet.Extensions.SemanticKernel and has 34 stars.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP