食堂 MCP
模型上下文协议 (MCP) 服务器可通过简单的 API 集成访问食堂的午餐菜单。
描述
Canteen MCP 是一个基于 FastMCP 的服务器,它提供了一个用于检索食堂每日午餐菜单的工具。它连接到菜单 API,并提供一个结构化的接口来查询特定日期的菜单数据。
Related MCP server: MCP API Service
特征
获取任何特定日期的午餐菜单
基于httpStream的实时通信传输
基于环境的配置
具有输入验证的类型安全 API
安装
npm install
配置
复制示例环境文件并使用您的值更新它:
cp .env.example .env
环境变量
多变的 | 描述 | 例子 |
API_URL | 午餐菜单 API 的 URL | |
港口 | MCP 服务器的端口 | 8080 |
端点 | HTTP 端点 | /端点 |
用法
启动服务器:
npm start
可用工具
获取午餐菜单
检索特定日期的午餐菜单。
参数:
date:YYYY-MM-DD 格式的字符串
返回:包含菜单数据的 JSON 字符串
例子:
const result = await tool.execute({ date: "2024-10-05" });
发展
先决条件
Node.js >= 18
npm
以开发模式运行
npm run dev
Docker
构建图像
docker build -t canteen-mcp .
运行容器
docker run -d \
-p 8080:3000 \
-e API_URL=your_api_url \
-e PORT=3000 \
-e ENDPOINT=/http \
--name canteen-mcp \
canteen-mcp
使用 GitHub 容器注册表
拉取最新镜像:
docker pull ghcr.io/[your-username]/canteen-mcp:latest
部署
部署到 Hetzner
通过 SSH 进入你的 Hetzner 服务器:
ssh root@your-server-ip
如果尚未安装,请安装 Docker:
curl -fsSL https://get.docker.com | sh
创建 docker-compose.yml 文件:
version: '3.8'
services:
canteen-mcp:
image: ghcr.io/c0dr/canteen-mcp:latest
restart: always
ports:
- "8080:3000"
environment:
- API_URL=your_api_url
- PORT=3000
- ENDPOINT=/http
启动服务:
docker-compose up -d
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅 LICENSE 文件。