Servidor MCP

Nota: las imágenes están en la carpeta img/ como img1.png y list.png. Si prefieres moverlas a docs/images/, actualiza las rutas aquí o avisame y las muevo.

https://learn.microsoft.com/es-es/dotnet/ai/quickstarts/build-mcp-server

Este README fue creado utilizando la plantilla de proyecto de servidor MCP en C#. Demuestra cómo puedes crear fácilmente un servidor MCP utilizando C# y publicarlo como un paquete NuGet.

El servidor MCP se construye como una aplicación autocontenida y no requiere que el runtime de .NET esté instalado en la máquina de destino. Sin embargo, dado que es autocontenido, debe compilarse para cada plataforma de destino por separado. Por defecto, la plantilla está configurada para compilar para:

• win-x64
• win-arm64
• osx-arm64
• linux-x64
• linux-arm64
• linux-musl-x64

Si tus usuarios requieren soporte para más plataformas, actualiza la lista de identificadores de runtime en el elemento <RuntimeIdentifiers /> del proyecto.

Consulta aka.ms/nuget/mcp/guide para la guía completa.

Ten en cuenta que esta plantilla se encuentra actualmente en una etapa de vista previa temprana. Si tienes comentarios, por favor completa una breve encuesta.

Lista de verificación antes de publicar en NuGet.org

• Prueba el servidor MCP localmente utilizando los pasos a continuación.
• Actualiza los metadatos del paquete en el archivo .csproj, en particular el <PackageId>.
• Actualiza .mcp/server.json para declarar las entradas de tu servidor MCP.
  • Consulta configurando entradas para más detalles.
• Empaqueta el proyecto utilizando dotnet pack.

El directorio bin/Release contendrá el archivo de paquete (.nupkg), que puede ser publicado en NuGet.org.

Desarrollo local

Para probar este servidor MCP desde el código fuente (localmente) sin utilizar un paquete de servidor MCP compilado, puedes configurar tu IDE para ejecutar el proyecto directamente utilizando dotnet run.

{
  "servers": {
    "MI_MCP": {
      "type": "stdio",
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "<RUTA AL DIRECTORIO DEL PROYECTO>"
      ]
    }
  }
}

Probando el servidor MCP

Usando el Inspector MCP

Para probar el servidor MCP de forma interactiva, puedes usar el inspector oficial de MCP. Esta herramienta te permite ejecutar y probar las herramientas del servidor en una interfaz gráfica en el navegador.

1. Asegúrate de tener Node.js instalado (versión 16 o superior).

2. Ejecuta el siguiente comando desde la raíz del proyecto (/Users/elbrinner/Documents/Develop/MCP_SIMPLES):

   npx @modelcontextprotocol/inspector --command "dotnet run --project MI_MCP/MI_MCP.csproj"
   

3. El inspector se abrirá automáticamente en tu navegador (por defecto en http://localhost:5173).

4. En la interfaz, podrás:

   • Ver todas las herramientas disponibles.
   • Ejecutar herramientas manualmente con parámetros.
   • Ver las respuestas en tiempo real.
   • Depurar errores si ocurren.

Esto es útil para desarrollo y pruebas rápidas sin necesidad de integrar con un cliente MCP completo.

Herramientas disponibles

1. Números aleatorios (RandomNumberTools)

• GetRandomNumber: Genera un número aleatorio entre un mínimo (inclusivo) y máximo (exclusivo).
  • Ejemplo: "Dame un número aleatorio entre 1 y 100" o "Genera 5 números aleatorios entre 10 y 50".

2. Clima (WeatherTools)

• GetCityWeather: Describe el clima aleatorio en una ciudad proporcionada. Puedes personalizar las opciones de clima configurando la vari

... View full README on GitHub