logo
Login
Cover image
mcp-tanteen-server
Private

mcp-tanteen-server

Try Now
2025-04-14

3 years

Works with Finder

0

Github Watches

0

Github Forks

0

Github Stars

餐厅数据 MCP Server

本服务用于查询职工餐厅就餐人数数据，提供指定日期范围内的早餐和午餐就餐人数统计。

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

安装

通过 pip 安装

pip install mcp-server-canteen

通过 uv 安装

uv pip install mcp-server-canteen

开发环境安装

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

环境变量配置

在使用服务之前，需要配置以下环境变量：

  • CANTEEN_API_TOKEN: API认证令牌
  • CANTEEN_API_BASE: API基础URL

环境变量获取方式

  1. 联系系统管理员获取 API 认证令牌
  2. API基础URL通常由系统管理员提供

设置环境变量

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

服务运行

使用 uv 运行

uv run mcp-server-canteen

使用 Python 运行

python -m mcp_server_canteen.server

功能说明

服务提供以下功能：

  • get_canteen_data: 查询指定日期范围内的餐厅就餐人数数据
    • 参数:
      • start_date: 开始日期，格式为YYYYMMDD（如20250331）
      • end_date: 结束日期，格式为YYYYMMDD（如20250331）
      • period: 相对时间范围，可选值：
        • today: 今天
        • yesterday: 昨天
        • day_before_yesterday: 前天
        • this_week: 本周
        • last_week: 上周
        • this_month: 本月
        • last_month: 上月
    • 返回: 包含早餐人数、午餐人数和总计人数的文本统计

使用 Claude for Desktop 作为客户端测试

配置

打开并编辑文件： ~/Library/Application\ Support/Claude/claude_desktop_config.json，内容如下：

使用 uvx 
"mcpServers": {
  "canteen": {
    "command": "uvx",
    "args": ["mcp-server-canteen"],
    "env": {
        "CANTEEN_API_TOKEN": "CANTEEN_API_TOKEN",
        "CANTEEN_API_BASE": "ANTEEN_API_BASE"
    }
  }
}
使用 uv 
"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"
    }
  }
}

重启 Claude for Desktop

重启不报错，且有锤子图标显示可用的 MCP Tool，即为成功；否则，查看日志排查

错误处理

常见错误及解决方案

  1. 环境变量未设置

    • 错误信息：缺少必要的环境变量配置
    • 解决方案：确保已正确设置所有必需的环境变量

  2. 日期格式错误

    • 错误信息：日期格式不正确，请使用YYYYMMDD格式
    • 解决方案：检查日期格式是否正确，例如：20240321

  3. API请求失败

    • 错误信息：HTTP请求失败 或 API返回错误
    • 解决方案：
      • 检查网络连接
      • 验证API令牌是否正确
      • 确认API基础URL是否正确

  4. 服务器连接失败

    • 错误信息：无法连接到MCP服务器
    • 解决方案：
      • 确保服务器正在运行
      • 检查端口是否被占用
      • 验证配置文件是否正确

Claude for Desktop 日志

日志文件夹：~/Library/Logs/Claude

来自具体 MCP Server 的日志：mcp-server-canteen.log

MCP 连接通用日志：mcp.log

工作原理

  1. 客户将您的查询发送给 Claude
  2. Claude 分析可用的工具并决定使用哪一个
  3. 客户端通过 MCP 服务器执行所选工具
  4. 结果被发回给 Claude
  5. Claude 制定了自然语言响应
  6. 答案已经展示给你了！

相关推荐

puerto

puerto

  • av

    • Ejecute sin esfuerzo LLM Backends, API, frontends y servicios con un solo comando.

    2 (1)
    1 panel

    1 panel

  • 1Panel-dev

    • 🔥 1Panel proporciona una interfaz web intuitiva y un servidor MCP para administrar sitios web, archivos, contenedores, bases de datos y LLM en un servidor de Linux.

    2 (1)
    impresionante-llm-recesses

    impresionante-llm-recesses

  • WangRongsheng

    • 🧑‍🚀 全世界最好的 llM 资料总结（数据处理、模型训练、模型部署、 O1 模型、 MCP 、小语言模型、视觉语言模型） | Resumen de los mejores recursos del mundo.

    3.5 (4)
    rulego

    rulego

  • rulego

    • ⛓️Rulego es un marco de motor de regla de orquestación de componentes de alta generación de alto rendimiento, de alto rendimiento y de alto rendimiento para GO.

    3.7 (10)
    rebaño

    rebaño

  • Onelevenvy

    • Flock es una plataforma de bajo código de flujo de trabajo para construir rápidamente chatbots, trapo y coordinar equipos de múltiples agentes, impulsados ​​por Langgraph, Langchain, Fastapi y Nextjs.

    3.2 (6)
    Pdfmathtranslate

    Pdfmathtranslate

  • Byaidu

    • Traducción de papel científico en PDF con formatos preservados - 基于 Ai 完整保留排版的 PDF 文档全文双语翻译 ， 支持 支持 支持 支持 支持 支持 支持 支持 支持 支持 支持 支持 等服务 等服务 等服务 提供 提供 提供 提供 提供 提供 提供 提供 提供 提供 提供 提供 cli/mcp/docker/zotero

    2 (1)
    n8n

    n8n

  • n8n-io

    • Plataforma de automatización de flujo de trabajo de código justo con capacidades de IA nativas. Combine el edificio visual con código personalizado, auto-anfitrión o nube, más de 400 integraciones.

    3 (1)
    Funciones LLM

    Funciones LLM

  • sigoden

    • Cree fácilmente herramientas y agentes de LLM utilizando funciones Plain Bash/JavaScript/Python.

    1 (1)
    CPP-MCP

    CPP-MCP

  • hkr04

    • SDK liviano C ++ MCP (Protocolo de contexto del modelo)

    3 (1)
    Langbot

    Langbot

  • RockChinQ

    • 😎简单易用、🧩丰富生态 - 大模型原生即时通信机器人平台 | 适配 Qq / 微信（企业微信、个人微信） / 飞书 / 钉钉 / Discord / Telegram / Slack 等平台 | 支持 Chatgpt 、 Deepseek 、 DiFy 、 Claude 、 Gemini 、 Xai 、 PPIO 、 Ollama 、 LM Studio 、阿里云百炼、火山方舟、 Siliconflow 、 Qwen 、 Moonshot 、 Chatglm 、 SillyTraven 、 MCP 等 LLM 的机器人 / Agente | Plataforma de bots de mensajería instantánea basada en LLM, admite Discord, Telegram, WeChat, Lark, Dingtalk, QQ, Slack

    5 (1)
    mínimos

    mínimos

  • dmayboroda

    • Trapo conversacional local con contenedores configurables

    3 (5)

    Reviews

    2.5 (6)
    Avatar
    user_dRRkvl0H
    2025-04-23

    I have been using the mcp-canteen-server by wrdan, and it has significantly improved the efficiency of our canteen operations. The setup process was straightforward, and the performance has been reliable. This tool is a must-have for managing canteen servers effectively. Highly recommend it!

    Avatar
    user_yOU5qpvI
    2025-04-23

    I've been using the mcp-canteen-server by wrdan for a while now, and it has significantly improved the efficiency of our canteen operations. The interface is user-friendly, and it integrates well with our existing systems. The welcome information is clear and helpful, making onboarding a breeze. Highly recommend this tool for any canteen management needs!

    Avatar
    user_NZirrFNZ
    2025-04-23

    As a dedicated user of MCP-Canteen-Server, I am extremely impressed with its performance and scalability. The seamless integration and intuitive interface have significantly improved the efficiency of our canteen management. Kudos to Wrdan for creating such a robust solution!

    Avatar
    user_cMy358o9
    2025-04-23

    I've been using the mcp-canteen-server by wrdan, and it has truly transformed the way I manage canteen operations. The intuitive interface and seamless integration have saved me a lot of time. Highly recommend to anyone looking to streamline their processes efficiently!

    Avatar
    user_vc7Oo1zJ
    2025-04-23

    The mcp-canteen-server by wrdan is an outstanding tool for managing canteen operations efficiently. Its user-friendly interface and robust features make it a must-have for any canteen. Highly recommended for its performance and reliability!

    Avatar
    user_y24lFiyZ
    2025-04-23

    The mcp-canteen-server by wrdan is an exceptional tool for managing canteen operations. This product offers seamless integration, efficient performance, and is pleasantly user-friendly. It greatly simplifies canteen management tasks, enhancing productivity. Highly recommended for canteen administrators!