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 制定了自然语言响应
答案已经展示给你了！

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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

Canteen MCP
c0dr
A
security
A
license
A
quality
A Model Context Protocol server that provides structured access to canteen lunch menus for specific dates through a simple API integration.
Last updated -
1
0
TypeScript
MIT License
HANDAAS Enterprise Big Data Service MCPofficial
handaas
-
security
F
license
-
quality
A server that provides enterprise data services including company information, profiles, business details, shareholders, investments, branches, and key personnel through keyword search and specific queries.
Last updated -
4
Variflight Tripmatch MCP Serverofficial
variflight
-
security
F
license
-
quality
Provides tools to query flight and train information including flight searches, train tickets, weather forecasts, and transfer options between different transportation modes.
Last updated -
15
Restaurant Booking MCP Server
samwang0723
A
security
A
license
A
quality
An AI-powered server that helps users discover and book restaurants based on location, cuisine preferences, mood, and event type, with integration to Google Maps Places API for accurate recommendations.
Last updated -
5
3
TypeScript
MIT License

View all related MCP servers