‫راهنمای کاربردی MCP

• مقدمه (که در حال حاضر در حال مطالعه آن هستید)
• بخش 1 - ساخت یک سرور MCP پایه
• بخش 2 - استفاده از سرور اکو (Echo) با VS Code
• بخش 3 - ابزار MCP برای حل مسئله Knight's Tour
• بخش 4 - استفاده از ابزار MCP با Claude برای دسکتاپ
• پیوست - با ابزار در مقابل بدون ابزار

• ایجاد سرور MCP خودتان
• استفاده از سرور MCP خود در VS Code با حالت Agent، با استفاده از GitHub Copilot

• VS Code
• حساب GitHub Copilot (یک حساب رایگان کافی است)
• NET SDK.
• اختیاری: Claude برای دسکتاپ

dotnet new console

dotnet add package ModelContextProtocol --prerelease
dotnet add package Microsoft.Extensions.Hosting

Program.cs

// Final Demo Version
// dotnet --version
// dotnet add package ModelContextProtocol --prerelease
// dotnet add package Microsoft.Extensions.Hosting

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using ModelContextProtocol.Server;
using System.ComponentModel;

var builder = Host.CreateApplicationBuilder(args);

builder.Logging.AddConsole(consoleLogOptions =>
{
   // Configure all logs to go to stderr
   consoleLogOptions.LogToStandardErrorThreshold = LogLevel.Trace;
});

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

await builder.Build().RunAsync();

[McpServerToolType]
public static class EchoTool
{
   [McpServerTool, Description("Returns the client's messages exactly as they were received, like an echo.")]
   public static string Echo(string message) => $"Hello, there! I am Echo, the MCP Server — The sound of your digital soul bouncing back: {message}";
}

dotnet run

info: ModelContextProtocol.Protocol.Transport.StdioServerTransport[857250842]
Server (stream) (mcp) transport reading messages.
info: Microsoft.Hosting.Lifetime[0]
Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
Hosting environment: Production
info: Microsoft.Hosting.Lifetime[0]
Content root path: C:\Projects\demo\Echo\Server

• AddMcpServer یک سرور MCP را به برنامه اضافه می‌کند.
• WithStdioServerTransport از حمل و نقل استاندارد IO برای ارتباط بین سرور و کلاینت استفاده می‌کند.
• WithToolsFromAssembly به سرور MCP می‌گوید که ابزارها را از اسمبلی فعلی بارگیری کند.

• McpServerToolType یک ویژگی کلاس است که نشان می‌دهد این کلاس حاوی ابزارهای MCP است.
• McpServerTool یک ویژگی متد است که نشان می‌دهد این متد یک ابزار MCP است.
• Description یک ویژگی متد است که توضیحی برای ابزار ارائه می‌دهد. این برای کلاینت MCP برای درک هدف ابزار استفاده می‌شود.

[
 {
   "mcpServer": "Echo",
   "command": "dotnet",
   "arg": [
     "run",
     "--project",
     "C:\Projects\demo\Echo\Server\Echo.csproj"
   ]
 }
]

• mcpServer نام سرور MCP است. این می‌تواند هر رشته‌ای باشد.
• command دستور اجرای سرور MCP است.
• arg آرگومان‌های دستور هستند.

Hello, there! I am Echo, the MCP Server — The sound of your digital soul bouncing back: Hello, Echo!

dotnet add package ModelContextProtocol --prerelease
dotnet add package Microsoft.Extensions.Hosting

// Final Demo Version
// dotnet --version
// dotnet add package ModelContextProtocol --prerelease
// dotnet add package Microsoft.Extensions.Hosting

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;  
using ModelContextProtocol.Server;
using System.ComponentModel;
var builder = Host.CreateApplicationBuilder(args);
builder.Logging.AddConsole(consoleLogOptions =>
{
   // Configure all logs to go to stderr
   consoleLogOptions.LogToStandardErrorThreshold = LogLevel.Trace;
});

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

await builder.Build().RunAsync();

[McpServerToolType]
public static class KnightsTourTool
{
   private static readonly KnightsTourSolver solver = new KnightsTourSolver();

   [McpServerTool, Description("Solves the Knight's Tour puzzle on a chessboard.")]
   public static string SolveKnightsTour(int startX, int startY, int boardSize)
   {
      var solution = solver.Solve(startX, startY, boardSize);
      if (solution == null)
      {
        return "No solution found.";
      }
      else
      {
        return $"Solution: {string.Join(" -> ", solution.Select(p => $"({p.X}, {p.Y})"))}";
      }
    }
}

• startX: مختصات X مربع شروع.
• startY: مختصات Y مربع شروع.
• boardSize: اندازه صفحه شطرنج.

[
 {
   "mcpServer": "KnightsTour",
    "command": "dotnet",
    "arg": [
      "run",
      "--project",
      "C:\Projects\demo\KnightsTour\Server\KnightsTour.csproj"
    ]
 }
]

• مختصات X مربع شروع.
• مختصات Y مربع شروع.
• اندازه صفحه شطرنج.

Solve the Knight's Tour puzzle starting at (0, 0) on an 8x8 board.

Solution: (0, 0) -> (1, 2) -> (2, 0) -> (4, 1) -> (3, 3) -> (1, 4) -> (0, 2) -> (2, 3) -> (4, 2) -> (3, 0) -> (1, 1) -> (0, 3) -> (2, 4) -> (4, 3) -> (3, 1) -> (1, 0) -> (2, 2) -> (0, 1) -> (1, 3) -> (3, 2) -> (4, 0) -> (2, 1) -> (0, 0)