C# MCP SDK

개요

C# MCP SDK(저장소: modelcontextprotocol/csharp-sdk)는 Microsoft와 협력하여 개발된 Model Context Protocol의 공식 .NET SDK입니다. 관용적인 C# API를 사용하여 MCP 서버와 클라이언트를 구현할 수 있게 해주어 .NET 개발자가 AI 에이전트를 .NET 애플리케이션, 엔터프라이즈 데이터 소스, 내부 API 및 맞춤형 워크플로우에 쉽게 연결할 수 있습니다.

2025년 11월 25일 MCP 사양을 완전히 지원하는 안정 버전 v1.0으로 2026년 3월에 출시된 이 SDK는 공식 MCP 생태계의 Tier 1 등급에 속하며, C#/.NET 팀이 성장하는 MCP 환경에 참여하는 권장 방법입니다.

주요 기능

• 전체 MCP 사양 지원: Tools, Resources, Prompts, Elicitation, Sampling 및 실험적 Tasks를 포함한 최신 2025-11-25 프로토콜 구현.
• 세 가지 NuGet 패키지:
  • ModelContextProtocol.Core — 클라이언트 및 저수준 서버를 위한 최소 의존성.
  • ModelContextProtocol — 대부분의 사용 사례를 위한 완전한 기능.
  • ModelContextProtocol.AspNetCore — HTTP/SSE 전송을 위한 ASP.NET Core와의 원활한 통합. – 쉬운 도구 정의: 속성(attribute)으로 메서드를 데코레이팅하거나 유창한 API를 사용하여 C# 함수를 자동 JSON 스키마 생성과 함께 MCP 도구로 노출.
• 내장 인증: OAuth 2.1, OpenID Connect 검색, PKCE 및 증분 범위 동의에 대한 최고 수준 지원.
• 다중 전송 방식: stdio, HTTP, SSE 및 Streamable HTTP. / Microsoft.Extensions.AI 통합: Semantic Kernel 및 기타 .NET AI 라이브러리와의 원활한 상호운용성.
• 프로덕션 준비 완료: 가시성, 로깅, 의존성 주입, HttpContext 액세스 및 AOT 호환성 옵션.
• 우수한 문서화: csharp.sdk.modelcontextprotocol.io에서 제공하는 포괄적인 API 문서.

작동 방식

MCP 서버 구축(최소 예제)

using ModelContextProtocol;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddMcpServer()
    .WithHttpTransport()
    .WithTools<MyCustomTools>();

var app = builder.Build();
app.MapMcp();
app.Run();

도구를 간단히 정의:

public class MyCustomTools
{
    [McpTool]
    public string GetWeather(string city) 
        => $"{city}에서 화창함";
}

AI 에이전트(Claude Desktop, Cursor 등)는 이러한 도구를 자동으로 발견하고 호출할 수 있습니다.

사용 사례

• 엔터프라이즈 데이터 통합: 내부 데이터베이스, CRM 시스템 또는 비즈니스 API를 AI 에이전트에 안전하게 노출. .
• 에이전트용 .NET 도구: AI가 dotnet CLI, Roslyn 분석기, NuGet 패키지 또는 Azure 리소스를 제어할 수 있는 MCP 서버 구축. – 맞춤형 AI 워크플로우: 레거시 .NET 서비스를 현대적인 에이전트 애플리케이션에 연결. .
• 하이브리드 AI 애플리케이션: MCP를 Semantic Kernel 또는 Microsoft.Extensions.AI와 결합하여 풍부한 에이전트 경험 제공.
• 내부 개발자 도구: 코드 생성, 배포 또는 모니터링을 위한 조직별 맞춤형 도구 생성.

시작하기

1. 메인 패키지를 설치합니다:

   dotnet add package ModelContextProtocol
   

2. GitHub 저장소 또는 SDK 문서의 공식 빠른 시작 가이드를 따라 진행합니다.

3. microsoft/mcp-dotnet-samples에서 다양한 샘플을 탐색해 보세요.

이 SDK는 콘솔 앱, ASP.NET Core, Azure Functions 등 다양한 환경에서 작동합니다. 서버와 클라이언트 구현 모두를 완벽하게 지원합니다.

장점

C# MCP SDK는 익숙한 패턴, 강력한 타입 지정, 의존성 주입, 엔터프라이즈급 보안과 함께 Model Context Protocol의 강력함을 .NET 생태계에 가져옵니다. .NET 팀이 제품용 MCP 서버를 구축하는 장벽을 낮추면서도 광범위한 MCP 생태계(Claude, Cursor, Gemini CLI 등)와 완전한 호환성을 유지합니다.

Microsoft와 함께 유지 관리되는 Tier 1 공식 SDK로서, 진화하는 MCP 사양에 맞춰 적시에 업데이트되며 내부 도구와 공용 AI 통합 모두에 널리 사용됩니다.

공식 링크:

• GitHub: https://github.com/modelcontextprotocol/csharp-sdk
• 문서: https://csharp.sdk.modelcontextprotocol.io/
• .NET 블로그 발표: https://devblogs.microsoft.com/dotnet/release-v10-of-the-official-mcp-csharp-sdk/