‫پروتکل متن مدل (MCP): رویکردی نوین در تعامل هوش مصنوعی با دنیای خارج در NET.

• مشتری MCP (MCP Client): می‌تواند هر برنامه، ربات یا عامل هوشمند مبتنی بر هوش مصنوعی مانند GitHub Copilot، Cursor IDE یا Claude Desktop باشد. این بخش از طریق اتصال به سرورهای MCP، از قابلیت‌های منابع خارجی بهره می‌برد.
• سرورهای MCP (MCP Servers): این سرورها به منابع یا ابزارهای خارجی متصل شده و متن (Context) دریافتی از عامل هوشمند را به متن مناسب برای ابزار یا API مورد نظر ترجمه می‌کنند.
• منابع/ابزارهای خارجی (External Tools/Resources): شامل هر نوع منبع داده یا ابزاری مانند پایگاه‌های داده، سیستم‌های فایل، APIها یا سایر برنامه‌های کاربردی است که اطلاعات از طریق سرور MCP از آن‌ها استخراج شده و به مشتری MCP بازگردانده می‌شود.

• ModelContextProtocol
• Microsoft.Extensions.Hosting

var builder = Host.CreateEmptyApplicationBuilder(null);

builder.Services.AddMcpServer()
    .WithStdioServerTransport()
    .WithToolsFromAssembly();

builder.Services.AddSingleton(_ => new HttpClient());

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

[McpServerToolType]
public class IpInfoTool
{
    [McpServerTool, Description("Get IP related information for a given IP address")]
    public static async Task<IpInfo> GetIpInfo(HttpClient httpClient,
        [Description("The IP address to get the related information")] string ip)
    {
        var ipInfo = await httpClient.GetFromJsonAsync<IpInfo>($"https://ipinfo.io/{ip}?token=your_api_token");
        return ipInfo;
    }
}

StdioClientTransport ct = new(
    new()
    {
        Name = "IpInfoServer",
        Command = "Your_path_to_the_server_exe"
    }
);

await using var mcpClient = await McpClientFactory.CreateAsync(ct,
        new()
        {
            ClientInfo = new() { Name = "IpInfoServer", Version = "1.0.0.0" }
        })
    .ConfigureAwait(false);

var tools = await mcpClient.ListToolsAsync().ConfigureAwait(false);

foreach (var tool in tools)
{
    Console.WriteLine($"{tool.Name} => {tool.Description}");
}

GetIpInfo => Get IP related information for a given IP address

Dictionary<string, object> parameters = new()
{
    ["ip"] = "Your_IP_Address"
};

var response = await mcpClient.CallToolAsync("GetIpInfo", parameters).ConfigureAwait(false);
if (response.IsError)
{
    Console.WriteLine($"Error");
}
else
{
    foreach (var content in response.Content)
    {
        Console.WriteLine(content.Text);
    }
}

{
  "ip":"Your_IP_Address",
  "city":"Your_City",
  "region":"Your_Region",
  "country":"Your_Country",
  "loc":"Your_Lat_Lng",
  "postal":"Your_Postal_Code"
}