Crea tu primer Servidor MCP (remoto) con .NET Web API

Un Model Context Protocol (MCP) es un protocolo que permite a los desarrolladores crear herramientas para interactuar con asistentes de IA y de esa forma extender sus capacidades.

Crear un servidor MCP no es tan complicado, pero es fundamental entender su concepto y funcionamiento antes de continuar. Así, te resultará más sencillo comprender todos los pasos que seguiremos a continuación para alcanzar ese primer objetivo con claridad y precisión.

Configuración inicial del proyecto

Primero, debes de crear un nuevo proyecto Web API y agregar las dependencias necesarias. En mi caso, lo haré usando la terminal con dotnet CLI, pero también puedes hacerlo desde Visual Studio.

Ten en cuenta que también puedes usar un proyecto existente.

Enseguida te dejare los comandos para inicializar el proyecto e instalar la dependencia oficial de MCP para .NET disponible mediante la terminal:

# crea el proyecto Web API
dotnet new webapi -n McpWebApi
# ingresamos al directorio del proyecto e instalamos la dependencia oficial de MCP par .NET
cd McpWebApi
dotnet add package ModelContextProtocol.AspNetCore --prerelease

Configuración del servidor MCP

En este punto integraremos ModelContextProtocol.AspNetCore, para ello modifica el archivo principal Program.cs. Ahí es donde registrarás los servicios así como el mapper para obtener las herramientas o tools que crees.

A continuación te dejo el ejemplo de como debería quedar:

var builder = WebApplication.CreateBuilder(args);

// Agregamos los servicios necesarios para MCP
builder.Services.AddMcpServer()
    .WithHttpTransport()
    .WithToolsFromAssembly();

// Código existente...

var app = builder.Build();

// Mapeamos el MCP en la aplicación
app.MapMcp();

// Código existente...

app.Run();

Crea tu primera tool (herramienta) de MCP

Antes de comenzar, crea una carpeta llamada Tools dentro del proyecto para tener en un lugar organizado todas tus herramientas.

mkdir Tools

Implementando nuestro tool: Hello World!

Dentro de la carpeta Tools, crea el archivo WelcomeTool.cs con el siguiente contenido:

using System.ComponentModel;
using ModelContextProtocol.Server;

namespace McpWebApi.Tools;

[McpServerToolType]
public static class WelcomeTool
{
    [McpServerTool, Description("Returns a welcome message with the provided name.")]
    public static string SayWelcomeMessage(String name)
    {
        return $"Welcome to MCP, {name}!";
    }
}

Puntos importantes:

• [McpServerToolType]: Marca la clase como contenedora de herramientas MCP. Ten en cuenta que este atributo servirá como guía para obtener todas las Server Tools mediante el mapper configurado con app.MapMcp().

• [McpServerTool]: Identifica el método como una herramienta o tool disponible.

• Description: Proporciona contexto sobre qué hace la herramienta.

Como puedes observar, crear un tool es similar a crear un controlador en un proyecto de .NET. Seguramente debe de parecerte familiar.

Ejecutando el servidor

Con todo configurado, ejecuta el proyecto con el siguiente comando:

dotnet run

Luego de eso, verifica en la consola la url de tu servidor, en mi caso es http://localhost:5038.

Si usas Visual Studio, lo más probable es que la URL se abra automáticamente en tu navegador.

Configuración de VS Code para usar tu MCP

Configuración del servidor MCP

Para que VS Code reconozca tu servidor MCP, necesitaremos crear un archivo de configuración. Para ello creamos la carpeta .vscode y el dentro el archivo mcp.json de la siguiente manera:

{
    "servers": {
        "my-first-mcp-server": {
            "url": "http://localhost:5038",
            "type": "http"
        }
    },
    "inputs": []
}

Detalles de la configuración:

• my-first-mcp-server: Nombre identificador de tu servidor (puedes modificarlo a tu gusto).

• url: Es la dirección donde estará corriendo nuestro servidor MCP.

• type: Especifica que usaremos HTTP con SSE en este caso.

También puedes usar el comando > MCP: Add Server en VS Code (como alternativa):

1. Abre la paleta de comandos (Cmd/Ctrl + Shift + P)

2. Busca "MCP: Add Server"

3. Sigue las instrucciones para configurar tu servidor, será mucho más fácil posiblemente.

Prueba tu MCP con GitHub Copilot Chat

Iniciando el servidor MCP

Una vez que tengas el archivo mcp.json configurado, asegúrate de que tu proyecto .NET esté corriendo. Para hacerlo, debes de ir de nuevo al archivo JSON y te aparecerá el estado del servidor MCP así como la opción de iniciar en el caso de que no lo esté.

Alternativamente, puedes ir a la sección de extensiones → MCP SERVERS → busca tu servidor y haz clic en "Start Server".

Configurando Github Copilot Chat

Probamos la funcionalidad de nuestros tools

Primero envía el siguiente mensaje en el chat de Copilot:

Envía un mensaje de bienvenida para Frank

Como es la primera vez, se te pedirá permiso para ejecutar la herramienta:

Y una vez que aceptes, si todo está bien configurado, te responderá algo como:

Welcome to MCP, Frank!

Ejemplo de mi resultado:

Y felicidades 🥳, de esta forma habrás creado tu primera tool (herramienta) de MCP.

Herramientas avanzadas con servicios asíncronos

También debes de tener en cuenta que para otros casos, sí puedes crear herramientas que interactúen con servicios externos y de forma asíncrona. Por ejemplo, si quieres buscar canciones en Deezer, puedes crear una herramienta que use un servicio para interactuar con la API de Deezer.

Enseguida de dejaré un ejemplo que probé y si funciona a la perfección:

using System.ComponentModel;
using McpWebApi.Extensions;
using McpWebApi.Services;
using ModelContextProtocol.Server;

namespace McpWebApi.Tools;

[McpServerToolType]
public class DeezerTool(
    IDeezerService deezerService
)
{
    [McpServerTool, Description("Search for tracks on Deezer")]
    public async Task<string> SearchDeezerTrack(string query)
    {
        var result = await deezerService.SearchTrackAsync(query);
        return result.ToMcpJson();
    }
}

Manejo de tipos de retorno

Importante: Las tools de MCP por lo menos mediante la librería que estamos usando, solo pueden retornar un string. Por lo tanto, si necesitas retornar un objeto o un modelo, debes de convertirlo a JSON.

En mi caso como puedes ver, cree una extensión para serializar objetos a JSON de forma sencilla, te dejaré el código de la extensión que usé:

using System.Text.Json;

namespace McpWebApi.Extensions;

public static class JsonExtensions
{
    private static readonly JsonSerializerOptions PrettyOptions = new()
    {
        WriteIndented = true,
        PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
        PropertyNameCaseInsensitive = true,
        DefaultIgnoreCondition = System.Text.Json.Serialization.JsonIgnoreCondition.WhenWritingNull
    };

    public static string ToMcpJson<T>(this T obj)
    {
        return JsonSerializer.Serialize(obj, PrettyOptions);
    }
}

Conclusión

Crear un servidor MCP con .NET y Web API (remoto) no es tan complicado como parece. Con unos pocos pasos, puedes tener un servidor corriendo y listo con todas las tools que necesites.

Eso sí, en mi caso, usé VS Code porque quería un enfoque más orientado al desarrollo multiplataforma, no limitado a Windows, como ocurriría si usara Visual Studio.

Eso sería todo, puedes dejar un comentario si tienes alguna duda. Hasta luego.