MCP Canteen Server

餐厅数据 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

环境变量获取方式

联系系统管理员获取 API 认证令牌
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，内容如下：

"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"
    }
  }
}

重启 Claude for Desktop

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

错误处理

常见错误及解决方案

环境变量未设置
- 错误信息：缺少必要的环境变量配置
- 解决方案：确保已正确设置所有必需的环境变量
日期格式错误
- 错误信息：日期格式不正确，请使用YYYYMMDD格式
- 解决方案：检查日期格式是否正确，例如：20240321
API请求失败
- 错误信息：HTTP请求失败 或 API返回错误
- 解决方案：
  - 检查网络连接
  - 验证API令牌是否正确
  - 确认API基础URL是否正确
服务器连接失败
- 错误信息：无法连接到MCP服务器
- 解决方案：
  - 确保服务器正在运行
  - 检查端口是否被占用
  - 验证配置文件是否正确

Claude for Desktop 日志

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

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

MCP 连接通用日志：mcp.log

工作原理

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

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

get_canteen_data

A service that provides cafeteria dining statistics, allowing users to query breakfast and lunch attendance numbers within a specified date range.

Related MCP Servers

lunchmoney-mcp
leafeye
A
security
A
license
A
quality
An MCP server that lets AI assistants interact with your Lunchmoney data, enabling natural language queries about transactions, budgets, and spending patterns.
Last updated -
4
3
8
TypeScript
MIT License
ActivityWatch MCP Server
8bitgentleman
A
security
A
license
A
quality
An interface that allows large language models like Claude to interact with ActivityWatch time tracking data through the Model Context Protocol, enabling queries about application usage, browsing history, and productivity patterns.
Last updated -
5
1
TypeScript
MIT License
Cal.com Calendar MCP Server
mumunha
-
security
F
license
-
quality
An MCP server that enables scheduling, updating, deleting, and listing calendar appointments through Cal.com's Calendar API.
Last updated -
JavaScript
Attendance Management MCP Server
shineliang
-
security
-
license
-
quality
A Model Context Protocol server that enables querying attendance information and managing employee leave requests, overtime requests, and schedules.
Last updated -
Python

View all related MCP servers