C#开发MCP/ChatGPT应用的核心思路与实践

1. 项目概述：C#开发MCP/ChatGPT应用的核心思路

MCP（Model Context Protocol）作为连接AI模型与外部服务的开放协议标准，正在成为构建ChatGPT生态应用的关键技术。使用C#开发这类应用，本质上是在ASP.NET Core框架基础上实现MCP协议的服务端组件，同时整合ChatGPT的交互能力。

从实际工程角度看，一个完整的MCP/ChatGPT应用包含三个核心模块：

• 协议实现层：处理MCP标准的请求/响应流程
• 业务逻辑层：封装具体的工具和资源操作
• 前端交互层：提供ChatGPT内的可视化界面

2. 开发环境准备与基础配置

2.1 必要组件安装

首先需要创建ASP.NET Core Web API项目，并添加以下NuGet包：

xml复制<ItemGroup>
    <PackageReference Include="ModelContextProtocol.AspNetCore" Version="1.1.0" />
    <PackageReference Include="Microsoft.AspNetCore.OpenApi" Version="10.0.3" />
    <PackageReference Include="Microsoft.OpenApi" Version="2.7.0" />
</ItemGroup>

2.2 服务初始化配置

在Program.cs中进行基础服务配置时，需要特别注意MCP服务的注册方式：

csharp复制var builder = WebApplication.CreateBuilder(args);

// 开发环境启用Swagger
if (builder.Environment.IsDevelopment())
{
    services.AddOpenApi();
    services.AddEndpointsApiExplorer();
    services.AddSwaggerGen();
}

// MCP核心服务注册
services.AddMcpServer().WithHttpTransport(options =>
{
    options.Stateless = true; // 采用无状态模式
})
.WithResources<WidgetResource>()
.WithTools<WidgetTool>();

var app = builder.Build();

// 中间件配置
app.UseCors(c => c.AllowAnyHeader().AllowAnyMethod().AllowAnyOrigin());
app.MapControllers();
app.UseMiddleware<AppAuthorizationMiddleware>();
app.MapMcp("mcp"); // MCP端点映射

app.Run();

关键提示：无状态模式(Stateless)更适合简单查询类应用，而有状态模式(Stateful)则适合需要维护会话上下文的复杂流程。选择时需要根据实际业务场景权衡。

3. MCP资源与工具的实现细节

3.1 资源类实现规范

资源类需要添加[McpServerResourceType]特性，每个对外暴露的资源方法需使用[McpServerResource]标注：

csharp复制[McpServerResourceType]
public class WidgetResource
{
    [McpServerResource(
        MimeType = "text/html;profile=mcp-app", 
        Name = "sample-app",
        UriTemplate = "ui://widget/app.html")]
    [McpMeta("openai/widgetPrefersBorder", false)]
    public async ValueTask<string> GetAppInterface()
    {
        // 返回HTML界面内容
    }
}

3.2 工具类开发要点

工具类是实现业务逻辑的核心，需要遵循特定规范：

csharp复制[McpServerToolType]
public class WidgetTool
{
    [McpServerTool(Name = "get-data")]
    [McpMeta("openai/outputTemplate", "ui://widget/app.html")]
    public static DataResult GetBusinessData([FromBody] RequestParams parameters)
    {
        // 处理业务逻辑
        return new DataResult { /*...*/ };
    }
}

4. 前端界面集成方案

4.1 前端项目结构

虽然使用C#作为后端，但前端仍需独立开发。推荐使用Vite+Vue3的组合：

code复制/ui
├── src
│   ├── mcp-app.ts    # MCP通信核心
│   └── App.vue       # 主界面组件
├── index.html        # 入口文件
└── vite.config.ts    # 构建配置

4.2 Vite关键配置

typescript复制// vite.config.ts
export default defineConfig({
  plugins: [vue(), viteSingleFile()],
  build: {
    rollupOptions: {
      input: 'index.html',
    },
    outDir: '../backend/wwwroot', // 输出到后端静态文件目录
  }
});

5. 认证授权实现方案

5.1 OAuth2.1端点配置

MCP应用需要提供标准的OAuth发现端点：

csharp复制[Route("/.well-known")]
public class WellKnownController : ControllerBase
{
    [HttpGet("oauth-authorization-server")]
    public object GetOAuthServer()
    {
        return new {
            issuer = "https://your-domain.com",
            authorization_endpoint = "https://your-domain.com/oauth/authorize",
            token_endpoint = "https://your-domain.com/oauth/token",
            scopes_supported = new[] { "mcp_access" }
        };
    }
}

5.2 授权中间件实现

自定义中间件验证MCP请求的授权头：

csharp复制public class AppAuthorizationMiddleware : IMiddleware
{
    public async Task InvokeAsync(HttpContext context, RequestDelegate next)
    {
        if (context.Request.Path.StartsWithSegments("/mcp"))
        {
            var token = context.Request.Headers.Authorization.ToString();
            if (string.IsNullOrEmpty(token))
            {
                context.Response.Headers.WWWAuthenticate = 
                    "Bearer resource_metadata=http://your-domain.com/.well-known/oauth-protected-resource";
                context.Response.StatusCode = 401;
                return;
            }
            // 实际验证逻辑...
        }
        await next(context);
    }
}

6. 调试与测试策略

6.1 使用MCP Inspector

官方提供的MCP Inspector工具可以模拟ChatGPT环境：

1. 配置服务端点URL
2. 设置认证令牌
3. 测试工具调用流程
4. 验证响应格式

6.2 单元测试要点

针对MCP工具类应编写专门的测试用例：

csharp复制[TestClass]
public class WidgetToolTests
{
    [TestMethod]
    public void GetData_WithValidParams_ReturnsExpectedFormat()
    {
        var result = WidgetTool.GetData(new RequestParams { /*...*/ });
        Assert.IsNotNull(result);
        // 验证响应结构...
    }
}

7. 性能优化建议

7.1 无状态服务的优化方向

1. 使用内存缓存频繁访问的数据
2. 实现请求批处理机制
3. 采用高效的JSON序列化方案
4. 优化数据库查询

7.2 有状态服务的注意事项

1. 会话存储选用Redis等高性能方案
2. 设置合理的会话过期时间
3. 实现会话分区策略
4. 监控会话内存使用情况

8. 常见问题解决方案

8.1 协议兼容性问题

问题表现：ChatGPT无法识别MCP端点
解决方案：

• 验证.well-known端点配置
• 检查MCP元数据格式
• 确保响应头包含Accept: application/x-mcp-json

8.2 认证失败处理

问题表现：401未授权错误
排查步骤：

1. 确认OAuth服务端点可达
2. 检查令牌有效期
3. 验证scope权限设置
4. 测试直接调用token端点

9. 项目部署实践

9.1 容器化部署示例

Dockerfile配置要点：

dockerfile复制FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
WORKDIR /app
COPY ./published .
ENTRYPOINT ["dotnet", "Your.Mcp.App.dll"]

9.2 云原生部署建议

1. 使用Kubernetes部署有状态服务
2. 配置水平Pod自动扩展
3. 实现零停机部署
4. 设置适当的健康检查

10. 进阶开发技巧

10.1 流式响应实现

对于长时间操作，可以实现流式响应：

csharp复制[McpServerTool]
public async IAsyncEnumerable<string> LongRunningTask()
{
    for (int i = 0; i < 10; i++)
    {
        yield return $"Progress {i * 10}%";
        await Task.Delay(1000);
    }
}

10.2 服务端推送技术

利用MCP的通知机制实现服务端推送：

csharp复制public class NotificationService
{
    private readonly IMcpNotifier _notifier;
    
    public void SendUpdate(string sessionId, string message)
    {
        _notifier.SendNotification(sessionId, new {
            type = "status_update",
            content = message
        });
    }
}

在实际项目中，我们发现MCP协议的灵活性既是优势也是挑战。特别是在处理复杂业务流时，建议先在小规模验证协议交互模式，再逐步扩展功能范围。对于C#开发者而言，充分利用ASP.NET Core的中间件管道可以大大简化MCP协议的集成工作。