C# MCP SDK

نظرة عامة

C# MCP SDK (المستودع: modelcontextprotocol/csharp-sdk) هو SDK .NET الرسمي لنموذج بروتوكول السياق، المُطور بالتعاون مع شركة مايكروسوفت. يسمح لمطوري .NET بتنفيذ خوادم وعملاء MCP باستخدام واجهات برمجة تطبيقات C# الاصطلاحية، مما يجعل توصيل وكلاء الذكاء الاصطناعي بتطبيقات .NET ومصادر بيانات المؤسسات وواجهات برمجة التطبيقات الداخلية وسير العمل المخصصة أمرًا بسيطًا.

تم إصدار الإصدار المستقر v1.0 في مارس 2026 مع دعم كامل لمواصفات MCP لعام 2025-11-25، وهو SDK من المستوى الأول في النظام البيئي الرسمي لـ MCP وهو الطريقة الموصى بها لفريق C#/.NET للمشاركة في مشهد MCP المتنامي.

الميزات الرئيسية

-Lفيقة بنسبة 100٪: دعم كامل لمواصفات MCP: تطبيق أحدث بروتوكول 2025-11-25 بما في ذلك الأدوات والموارد والمطالبات والاستدراج والاختيار والمهام التجريبية.

• ثلاث حزم NuGet:
  • ModelContextProtocol.Core — تبعيات قليلة للعملاء والخوادم منخفضة المستوى.
  • ModelContextProtocol — مميزات كاملة لمعظم حالات الاستخدام.
  • ModelContextProtocol.AspNetCore — تكامل سلس مع ASP.NET Core لنقل HTTP/SSE. -Sيئة سهلة للأدوات: استخدم الخصائص أو واجهات برمجة التطبيقات السلسة لتزيين الأساليب وكشف وظائف C# كأدوات MCP مع إنشاء مخطط JSON تلقائي.
• الترخيص المدمج: دعم من الدرجة الأولى لـ OAuth 2.1 واكتشاف OpenID Connect و PKCE وموافقة النطاق التدريجي.
• نقل متعدد: stdio و HTTP و SSE و Streamable HTTP.
• تكامل Microsoft.Extensions.AI: تشغيل بلا عوائق مع Semantic Kernel ومكتبات الذكاء الاصطناعي الأخرى لـ .NET.
• جاهز للإنتاج: إمكانية المراقبة وتسجيل الأحداث وحقن التبعيات ووصول HttpContext وخيارات التوافق مع AOT.
• وثائق ممتازة: وثائق API شاملة على csharp.sdk.modelcontextprotocol.io.

كيفية عملها

بناء خادم 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) 
        => $"Sunny in {city}";
}

يمكن لوكلاء الذكاء الاصطناعي (Claude Desktop، Cursor، إلخ) بعد ذلك اكتشاف واستدعاء هذه الأدوات تلقائيًا.

حالات الاستخدام

, الدمج في المؤسسات**: كشف قواعد البيانات الداخلية وأنظمة CRM أو واجهات برمجة التطبيقات التجارية لوكلاء الذكاء الاصطناعي بشكل آمن. -S أدوات .NET للوكلاء**: إنشاء خوادم MCP تسمح للذكاء الاصطناعي بالتحكم في واجهة سطر أوامر dotnet ومحللات Roslyn وحزم NuGet أو موارد Azure.

• سير عمل الذكاء الاصطناعي المخصص: توصيل خدمات .NET القديمة بتطبيقات الوكيل الحديثة.
• تطبيقات الذكاء الاصطناعي الهجينة: الجمع بين 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 قوة بروتوكول سياق النموذج إلى بيئة .NET مع أنماط مألوفة، تنميط قوي، حقن التبعيات، وأمان على مستوى المؤسسة. يخفض الحاجز أمام فرق .NET لبناء خوادم MCP للإنتاج مع الحفاظ على التوافق الكامل مع نظام MCP الأوسع (كلود، كورسور، واجهة سطر أوامر جيميني، إلخ.).

بصفه SDK رسمي من الدرجة الأولى يتم صيانته مع Microsoft، يتلقى تحديثات في الوقت المناسب تتماشى مع مواصفات MCP المتطورة ويستخدم على نطاق واسع لكل من أدوات داخلية وتكاملات الذكاء الاصطناعي العامة.

الروابط الرسمية:

• 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/