MCP 服务器

Model Context Protocol .NET Template

这个仓库包含一个用于在 .NET 中创建模型上下文协议 (MCP) 应用程序的模板。

NikiforovAll

开发者工具

访问服务器

README

Model Context Protocol .NET 模板

一个用于 LLM 应用程序和外部数据源之间无缝集成的协议

此仓库包含一个模板，用于在 .NET 中创建 Model Context Protocol (MCP) 应用程序。它提供了一个基本的结构和示例代码，以帮助您开始构建自己的 MCP 启用应用程序。

包	版本	描述
`Nall.ModelContextProtocol.Template`		模板
`Nall.ModelContextProtocol.Inspector.Aspire.Hosting`		Aspire 托管集成

开始使用

安装:

dotnet new install Nall.ModelContextProtocol.Template

验证安装:

dotnet new list mcp
# These templates matched your input: 'mcp'

# Template Name      Short Name         Language  Tags
# -----------------  -----------------  --------  -------------
# MCP Server         mcp-server         [C#]      dotnet/ai/mcp
# MCP Server SSE     mcp-server-sse     [C#]      dotnet/ai/mcp
# MCP Server Hybrid  mcp-server-hybrid  [C#]      dotnet/ai/mcp

[!TIP] 建议使用 mcp-server-hybrid 模板，因为它可以在模式之间方便地切换。它允许您在 Stdio 和 SSE 模式下运行服务器。

验证输出:

dotnet new mcp-server -o MyAwesomeMCPServer -n MyAwesomeMCPServer --dry-run
# File actions would have been taken:
#   Create: MyAwesomeMCPServer\.vscode\launch.json
#   Create: MyAwesomeMCPServer\MyAwesomeMCPServer.csproj
#   Create: MyAwesomeMCPServer\Program.cs
#   Create: MyAwesomeMCPServer\Properties\launchSettings.json
#   Create: MyAwesomeMCPServer\README.md
#   Create: MyAwesomeMCPServer\appsettings.Development.json
#   Create: MyAwesomeMCPServer\appsettings.json

从模板创建:

dotnet new mcp-server -o MyAwesomeMCPServer -n MyAwesomeMCPServer

这是 Program.cs 的内容:

using Microsoft.Extensions.Hosting;

var builder = Host.CreateApplicationBuilder(args);
builder.Services
    .AddMcpServer()
    .WithStdioServerTransport()
    .WithToolsFromAssembly();

await builder.Build().RunAsync();

[McpServerToolType]
public static class EchoTool
{
    [McpServerTool, Description("Echoes the message back to the client.")]
    public static string Echo(string message) => $"hello {message}";
}

这是一个简单的 echo 服务器，它侦听传入的消息并以问候语响应。您可以通过创建带有 [McpServerTool] 属性的附加方法来添加更多工具。 WithToolsFromAssembly() 方法会自动注册程序集中的所有工具。

本地运行

从项目目录构建:

dotnet build -o Artefacts -c Release

运行 inspector:

npx @modelcontextprotocol/inspector -e DOTNET_ENVIRONMENT=Production dotnet "$(PWD)/Artefacts/MyAwesomeMCPServer.dll"

在浏览器中打开 inspector 并测试服务器:

作为 .NET 工具分发

从项目目录打包:

dotnet pack -o Artefacts -c Release

全局安装该工具:

dotnet tool install --global --add-source ./Artefacts MyAwesomeMCPServer

现在，在全局安装此工具后，您可以从系统上的任何位置运行它。该工具将在您的终端中以 MyAwesomeMCPServer (或 myawesomemcpserver) 的形式提供。

💡 您还可以创建本地工具清单并在本地安装 MCP 作为工具。

运行 inspector:

npx @modelcontextprotocol/inspector -e DOTNET_ENVIRONMENT=Production myawesomemcpserver

使用 Aspire 运行

在 `Stdio` 模式下

在 AppHost/Program.cs 中:

var builder = DistributedApplication.CreateBuilder(args);

builder.AddMCPInspector().WithStdio<Projects.MCPServer>();

builder.Build().Run();

在 `SSE` 模式下

在 AppHost/Program.cs 中:

var builder = DistributedApplication.CreateBuilder(args);

var mcp = builder.AddProject<Projects.MCPServerSSE>("server");
builder.AddMCPInspector().WithSSE(mcp);

builder.Build().Run();