Canteen Data

Servidor MCP de Canteen Data

Este servicio se utiliza para consultar los datos del número de comensales de la cafetería de empleados, proporcionando estadísticas de desayuno y almuerzo para un rango de fechas específico.

docs: https://modelcontextprotocol.io/quickstart/server

Instalación

Instalación mediante pip

pip install mcp-server-canteen

Instalación mediante uv

uv pip install mcp-server-canteen

Instalación del entorno de desarrollo

git clone https://github.com/wrdan/mcp-server-canteen.git
cd mcp-server-canteen
uv pip install -e .

Configuración de variables de entorno

Antes de usar el servicio, es necesario configurar las siguientes variables de entorno:

• CANTEEN_API_TOKEN: Token de autenticación de API
• CANTEEN_API_BASE: URL base de la API

Cómo obtener las variables de entorno

1. Contacte al administrador del sistema para obtener el token de autenticación de API
2. La URL base de la API generalmente la proporciona el administrador del sistema

Configuración de variables de entorno

Windows

set CANTEEN_API_TOKEN=your_token
set CANTEEN_API_BASE=your_base_url

Linux/Mac

export CANTEEN_API_TOKEN=your_token
export CANTEEN_API_BASE=your_base_url

Ejecución del servicio

Ejecutar con uv

uv run mcp-server-canteen

Ejecutar con Python

python -m mcp_server_canteen.server

Descripción de funciones

El servicio ofrece las siguientes funciones:

• get_canteen_data: Consultar los datos del número de comensales de la cafetería en un rango de fechas específico
  • Parámetros:
    • start_date: Fecha de inicio, formato YYYYMMDD (por ejemplo, 20250331)
    • end_date: Fecha de fin, formato YYYYMMDD (por ejemplo, 20250331)
    • period: Rango de tiempo relativo, valores opcionales:
      • today: Hoy
      • yesterday: Ayer
      • day_before_yesterday: Anteayer
      • this_week: Esta semana
      • last_week: La semana pasada
      • this_month: Este mes
      • last_month: El mes pasado
  • Retorno: Estadísticas de texto que incluyen el número de desayunos, el número de almuerzos y el número total

Uso de Claude for Desktop como cliente de prueba

Configuración

Abra y edite el archivo: ~/Library/Application\ Support/Claude/claude_desktop_config.json, con el siguiente contenido:

"mcpServers": {
  "canteen": {
    "command": "uvx",
    "args": ["mcp-server-canteen"],
    "env": {
        "CANTEEN_API_TOKEN": "CANTEEN_API_TOKEN",
        "CANTEEN_API_BASE": "ANTEEN_API_BASE"
    }
  }
}

"mcpServers": {
  "canteen": {
    "command": "uv",
    "args": ["run", "mcp-server-canteen"],
    "env": {
        "CANTEEN_API_TOKEN": "CANTEEN_API_TOKEN",
        "CANTEEN_API_BASE": "ANTEEN_API_BASE"
    }
  }
}

"mcpServers": {
  "canteen": {
    "command": "python",
    "args": ["-m", "mcp-server-canteen.server"],
    "env": {
        "CANTEEN_API_TOKEN": "CANTEEN_API_TOKEN",
        "CANTEEN_API_BASE": "ANTEEN_API_BASE"
    }
  }
}

Reiniciar Claude for Desktop

Si se reinicia sin errores y aparece el icono 锤子 que muestra las herramientas MCP disponibles, es un éxito; de lo contrario, revise los registros para solucionar el problema.

Manejo de errores

Errores comunes y soluciones

1. Variables de entorno no configuradas

   • Mensaje de error: 缺少必要的环境变量配置
   • Solución: Asegúrese de haber configurado correctamente todas las variables de entorno necesarias

2. Formato de fecha incorrecto

   • Mensaje de error: 日期格式不正确，请使用YYYYMMDD格式
   • Solución: Verifique que el formato de fecha sea correcto, por ejemplo: 20240321

3. Error en la solicitud de API

   • Mensaje de error: HTTP请求失败 o API返回错误
   • Solución:
     • Verifique la conexión de red
     • Valide que el token de API sea correcto
     • Confirme que la URL base de la API sea correcta

4. Error de conexión al servidor

   • Mensaje de error: 无法连接到MCP服务器
   • Solución:
     • Asegúrese de que el servidor esté en ejecución
     • Verifique si el puerto está en uso
     • Valide que el archivo de configuración sea correcto

Registros de Claude for Desktop

Carpeta de registros: ~/Library/Logs/Claude

Registros del servidor MCP específico: mcp-server-canteen.log

Registro general de conexión MCP: mcp.log

Cómo funciona

1. El cliente envía su consulta a Claude
2. Claude analiza las herramientas disponibles y decide cuál usar
3. El cliente ejecuta la herramienta seleccionada a través del servidor MCP
4. El resultado se envía de vuelta a Claude
5. Claude formula una respuesta en lenguaje natural
6. ¡La respuesta ya se muestra para usted!