What is Mcp Dotnet Console

mcp-dotnet-console is a demonstration server that implements the Model Context Protocol (MCP) for .NET. It provides tools for managing a weekly meal menu and other example functionalities.

Use cases

Use cases include saving a specific dish for a day, retrieving personalized greetings, and managing weekly meal menus efficiently.

How to use

To use mcp-dotnet-console, clone the repository, restore dependencies, configure the database connection in appsettings.json, run database migrations, and start the server using ‘dotnet run --project McpDemoServer’. The server will be available at http://localhost:5000.

Key features

Key features include daily meal management, automatic calculation of monthly days for weekly planning, integration with Claude Desktop, and a REST API for data management.

Where to use

mcp-dotnet-console can be used in various fields such as meal planning applications, restaurant management systems, and any application requiring weekly scheduling functionalities.

MCP Demo Server

Este es un servidor de demostración que implementa el Model Context Protocol (MCP) para .NET. El servidor proporciona herramientas para gestionar un menú semanal de comidas y otras funcionalidades de ejemplo.

Características

• Gestión de platos de comida por día de la semana
• Cálculo automático de días del mes para planificación semanal
• Integración con Claude Desktop
• API REST para gestión de datos

Requisitos Previos

• .NET 8.0 SDK o superior
• Visual Studio 2022 o VS Code
• SQL Server (para la base de datos)

Instalación

1. Clona el repositorio:

git clone [URL del repositorio]
cd dotnet-mcp

2. Restaura las dependencias:

dotnet restore

3. Configura la base de datos:

   • Asegúrate de tener SQL Server instalado y corriendo
   • Actualiza la cadena de conexión en appsettings.json

4. Ejecuta las migraciones de la base de datos:

dotnet ef database update

Uso

1. Inicia el servidor:

dotnet run --project McpDemoServer

2. El servidor estará disponible en http://localhost:5000 (o el puerto configurado)

Integración con Claude Desktop

1. Abre Claude Desktop
2. Ve a la configuración de herramientas
3. Agrega una nueva herramienta con la siguiente configuración:
   • Nombre: MCP Demo Server
   • URL: http://localhost:5000
   • Descripción: Servidor de demostración MCP para gestión de menú semanal

Ejemplos de Uso

Guardar un plato para un día específico

// El sistema calculará automáticamente el día correcto del mes
await SaveFoodToDatabaseCurrentMonth("Pollo a la Brasa", "lunes");

Obtener un saludo personalizado

string saludo = GetSalutation("Usuario");

Estructura del Proyecto

• McpDemoServer/: Contiene el servidor principal
• McpDemoServer/Models/: Modelos de datos
• McpDemoServer/Services/: Servicios de negocio
• McpDemoServer/Controllers/: Controladores de la API

Contribución

1. Fork el repositorio
2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

Licencia

Este proyecto está bajo la Licencia MIT - ver el archivo LICENSE para más detalles.

Funcionalidad de Guardado de Platos

SaveFoodToDatabaseCurrentMonth

Esta funcionalidad permite guardar platos para cocinar en días específicos de la semana. Los platos se almacenan tanto en una base de datos local como en una hoja de Google Sheets para un seguimiento más completo.

Características:

• Guarda platos con su día de la semana correspondiente
• Almacena la información en una base de datos SQL Server local
• Sincroniza los datos con Google Sheets para acceso remoto
• Mantiene un registro histórico de los platos guardados

Requisitos Previos:

1. Base de Datos SQL Server:

   • SQL Server instalado y en ejecución
   • Base de datos FoodDB creada
   • Tabla Foods con la estructura adecuada
   • Usuario con permisos de lectura/escritura

2. Credenciales de Google Sheets:

   • Cuenta de Google Cloud Platform
   • Proyecto creado en Google Cloud Console
   • API de Google Sheets habilitada
   • Archivo de credenciales JSON

Configuración de Google Sheets:

1. Crear un Proyecto en Google Cloud Console:

   • Ve a Google Cloud Console
   • Crea un nuevo proyecto o selecciona uno existente
   • Anota el ID del proyecto

2. Habilitar la API de Google Sheets:

   • En el menú lateral, ve a “APIs y servicios” > “Biblioteca”
   • Busca “Google Sheets API”
   • Haz clic en “Habilitar”

3. Crear Credenciales:

   • En el menú lateral, ve a “APIs y servicios” > “Credenciales”
   • Haz clic en “Crear credenciales” > “Cuenta de servicio”
   • Completa los detalles de la cuenta de servicio
   • Asigna el rol “Editor” para permitir la escritura en hojas

4. Generar y Descargar el Archivo JSON:

   • En la lista de cuentas de servicio, haz clic en la que creaste
   • Ve a la pestaña “Claves”
   • Haz clic en “Agregar clave” > “Crear nueva clave”
   • Selecciona “JSON” como formato
   • Haz clic en “Crear”
   • El archivo se descargará automáticamente

5. Configurar el Archivo de Credenciales:

   • Renombra el archivo descargado a credentials.json
   • Colócalo en la raíz del proyecto (al mismo nivel que la carpeta McpDemoServer)
   • Asegúrate de que el archivo tenga permisos de lectura

6. Compartir la Hoja de Cálculo:

   • Crea una nueva hoja de cálculo en Google Sheets
   • Compártela con la dirección de correo de la cuenta de servicio (aparece en el archivo JSON)
   • Dale permisos de edición a la cuenta de servicio

Estructura de la Hoja de Cálculo:

La hoja debe tener una pestaña llamada “Comidas” con las siguientes columnas:

• Fecha
• Plato
• Día
• Mes

Uso:

// Ejemplo de uso
await SaveFoodToDatabaseCurrentMonth("Pollo a la Brasa", "martes");

Notas Importantes:

• El archivo de credenciales debe mantenerse seguro y no debe compartirse
• La hoja de cálculo debe tener la estructura correcta antes de usar la funcionalidad
• Se recomienda hacer una copia de seguridad regular de la base de datos local
• Los errores de conexión se registran en el archivo de log

Seguridad y Credenciales

Manejo de Credenciales de Google Sheets

Por razones de seguridad, el archivo credentials.json no está incluido en el repositorio. Para usar la funcionalidad de Google Sheets:

1. Sigue las instrucciones en la sección “Configuración de Google Sheets” para obtener tus propias credenciales
2. Renombra el archivo de credenciales descargado a credentials.json
3. Colócalo en la raíz del proyecto (al mismo nivel que la carpeta McpDemoServer)
4. IMPORTANTE: Nunca subas el archivo credentials.json al repositorio

Archivo de Ejemplo

Se incluye un archivo credentials.json.example como plantilla. Este archivo muestra la estructura esperada pero no contiene credenciales reales

.gitignore

El archivo .gitignore está configurado para excluir:

• credentials.json: Para evitar que las credenciales se suban al repositorio
• Otros archivos sensibles y temporales