Canteen Data

Consultar dados de

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP Canteen Data

Este serviço é usado para consultar dados de número de refeições dos funcionários no refeitório, fornecendo estatísticas de café da manhã e almoço para um intervalo de datas especificado.

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

Instalação

Instalação via pip

pip install mcp-server-canteen

Instalação via uv

uv pip install mcp-server-canteen

Instalação do ambiente de desenvolvimento

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

Configuração de variáveis de ambiente

Antes de usar o serviço, é necessário configurar as seguintes variáveis de ambiente:

  • CANTEEN_API_TOKEN: Token de autenticação da API
  • CANTEEN_API_BASE: URL base da API

Como obter as variáveis de ambiente

  1. Entre em contato com o administrador do sistema para obter o token de autenticação da API
  2. A URL base da API geralmente é fornecida pelo administrador do sistema

Configurando variáveis de ambiente

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

Execução do serviço

Executando com uv

uv run mcp-server-canteen

Executando com Python

python -m mcp_server_canteen.server

Descrição dos recursos

O serviço oferece os seguintes recursos:

  • get_canteen_data: Consulta dados de número de refeições no refeitório para um intervalo de datas especificado
    • Parâmetros:
      • start_date: Data de início, no formato YYYYMMDD (ex.: 20250331)
      • end_date: Data de término, no formato YYYYMMDD (ex.: 20250331)
      • period: Intervalo de tempo relativo, valores opcionais:
        • today: Hoje
        • yesterday: Ontem
        • day_before_yesterday: Anteontem
        • this_week: Esta semana
        • last_week: Semana passada
        • this_month: Este mês
        • last_month: Mês passado
    • Retorno: Estatísticas em texto contendo número de café da manhã, número de almoço e número total

Usando Claude for Desktop como cliente de teste

Configuração

Abra e edite o arquivo: ~/Library/Application\ Support/Claude/claude_desktop_config.json, com o seguinte conteúdo:

usando uvx 
"mcpServers": {
  "canteen": {
    "command": "uvx",
    "args": ["mcp-server-canteen"],
    "env": {
        "CANTEEN_API_TOKEN": "CANTEEN_API_TOKEN",
        "CANTEEN_API_BASE": "ANTEEN_API_BASE"
    }
  }
}
usando uv 
"mcpServers": {
  "canteen": {
    "command": "uv",
    "args": ["run", "mcp-server-canteen"],
    "env": {
        "CANTEEN_API_TOKEN": "CANTEEN_API_TOKEN",
        "CANTEEN_API_BASE": "ANTEEN_API_BASE"
    }
  }
}
teste local 
"mcpServers": {
  "canteen": {
    "command": "python",
    "args": ["-m", "mcp-server-canteen.server"],
    "env": {
        "CANTEEN_API_TOKEN": "CANTEEN_API_TOKEN",
        "CANTEEN_API_BASE": "ANTEEN_API_BASE"
    }
  }
}

Reinicie o Claude for Desktop

Se reiniciar sem erros e com o ícone 锤子 exibindo as ferramentas MCP disponíveis, o processo foi bem-sucedido; caso contrário, verifique os logs para solucionar problemas

Tratamento de erros

Erros comuns e soluções

  1. Variáveis de ambiente não configuradas

    • Mensagem de erro: 缺少必要的环境变量配置
    • Solução: Certifique-se de que todas as variáveis de ambiente necessárias foram configuradas corretamente

  2. Erro no formato da data

    • Mensagem de erro: 日期格式不正确，请使用YYYYMMDD格式
    • Solução: Verifique se o formato da data está correto, por exemplo: 20240321

  3. Falha na solicitação à API

    • Mensagem de erro: HTTP请求失败 ou API返回错误
    • Solução:
      • Verifique a conexão de rede
      • Valide se o token da API está correto
      • Confirme se a URL base da API está correta

  4. Falha na conexão com o servidor

    • Mensagem de erro: 无法连接到MCP服务器
    • Solução:
      • Certifique-se de que o servidor está em execução
      • Verifique se a porta está em uso
      • Valide se o arquivo de configuração está correto

Logs do Claude for Desktop

Pasta de logs: ~/Library/Logs/Claude

Logs de um servidor MCP específico: mcp-server-canteen.log

Logs gerais de conexão MCP: mcp.log

Como funciona

  1. O cliente envia sua consulta para o Claude
  2. O Claude analisa as ferramentas disponíveis e decide qual usar
  3. O cliente executa a ferramenta selecionada por meio do servidor MCP
  4. O resultado é enviado de volta para o Claude
  5. O Claude elabora uma resposta em linguagem natural
  6. A resposta é exibida para você!