餐厅数据 MCP Server

基本能力

产品定位

mcp-server-canteen 是一个专门用于查询职工餐厅就餐人数数据的服务，旨在为企业和组织提供餐厅就餐情况的统计和分析。

核心功能

• 查询指定日期范围内的餐厅就餐人数数据
• 支持绝对日期范围（YYYYMMDD格式）
• 支持相对时间范围（如今天、昨天、本周、上周等）
• 返回包含早餐人数、午餐人数和总计人数的文本统计

适用场景

• 企业或组织需要统计员工餐厅就餐情况
• 餐厅管理者需要了解就餐高峰期
• 人力资源部门需要分析员工就餐习惯

工具列表

• get_canteen_data: 查询餐厅就餐人数数据
• 参数:
  • start_date: 开始日期
  • end_date: 结束日期
  • period: 相对时间范围
• 返回: 包含早餐人数、午餐人数和总计人数的文本统计

常见问题解答

1. 环境变量未设置
2. 错误信息：缺少必要的环境变量配置

3. 解决方案：确保已正确设置所有必需的环境变量

4. 日期格式错误

5. 错误信息：日期格式不正确，请使用YYYYMMDD格式

6. 解决方案：检查日期格式是否正确，例如：20240321

7. API请求失败

8. 错误信息：HTTP请求失败 或 API返回错误

9. 解决方案：

   • 检查网络连接
   • 验证API令牌是否正确
   • 确认API基础URL是否正确

10. 服务器连接失败

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

使用教程

使用依赖

• Python 环境
• 需要配置以下环境变量：
• CANTEEN_API_TOKEN: API认证令牌
• CANTEEN_API_BASE: API基础URL

安装教程

通过 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 .

环境变量配置

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

调试方式

• 检查日志文件：
• 日志文件夹：~/Library/Logs/Claude
• 具体 MCP Server 的日志：mcp-server-canteen.log
• MCP 连接通用日志：mcp.log
• 重启 Claude for Desktop 并检查是否有锤子图标显示可用的 MCP Tool

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。