Schedule Shift MCP

MCP运维云端

提供方 Zyr-0901

运维云端 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

一个基于 FastMCP 的 MCP Server,提供查询可约档期和提交调班申请的功能,适用于教育领域的临时调班场景。

一句话选型结论

按资料字段整理

Schedule Shift MCP 属于运维云端类 MCP 服务器,stdio · 本地进程,无需鉴权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

教育调班Python本地部署MCPServerFastAPIHTTP服务

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
python run_mcp_server.py

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Schedule Shift MCP当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方Zyr-0901上游标注的维护方 Zyr-0901
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.9 KB
来自项目仓库与上游目录的原文,未做删改

需求说明:教育-临时调班 MCP Server(Python / HTTP)

1) 目标

在本地实现一个 MCP Server:schedule-shift-mcp,通过 Streamable HTTP 对外提供 MCP 工具能力(HTTP 传输是 MCP 标准传输之一)。 (Model Context Protocol)

服务要暴露 2 个 tools:

  • query_available_slots:查可约档期(如果目标满员,要自动给替代方案)
  • submit_schedule_change:核验后提交调班(返回成功/待审核/失败原因)

2) 技术选型(必须)

  • Python
  • 使用 FastMCP 来实现 MCP Server(简化协议细节)
  • 传输方式:transport="http",MCP 端点默认在 /mcp/(同域名根路径可挂 /health) (gofastmcp.com)

> FastMCP 支持把 MCP 服务作为 HTTP Web 服务运行,并且 MCP endpoint 在 /mcp/。 (gofastmcp.com)

3) 运行方式

方式 1:FastAPI + MCP 挂载(推荐,支持 REST API 和 MCP)```bash

uvicorn app:app --host 0.0.0.0 --port 8000


**端点**:
* MCP endpoint:`http://localhost:8000/mcp/`
* 健康检查:`GET http://localhost:8000/health`
* REST API:`/api/query-available-slots`, `/api/submit-schedule-change`
* API 文档:
- Swagger UI:`http://localhost:8000/docs`
- OpenAPI JSON:`http://localhost:8000/openapi.json`
- ReDoc:`http://localhost:8000/redoc`

#### 方式 2:独立 MCP 服务器(仅 MCP 协议)

如果方式 1 无法正常工作,可以尝试独立运行 MCP 服务器:```bash
python run_mcp_server.py

端点:
* MCP endpoint:http://localhost:8000/mcp/

> 注意:
> - FastAPI 的文档端点(/docs, /openapi.json)在主应用根路径下,不在 /mcp/ 路径下
> - FastMCP 的 http_app() 返回的 ASGI 应用只处理 MCP 协议请求,不包含 FastAPI 的文档功能
> - 如果 MCP 客户端无法连接,请检查:
> 1. 服务器是否正常启动
> 2. MCP 端点 URL 是否正确(http://localhost:8000/mcp 或 http://localhost:8000/mcp/)
> 3. 运行诊断脚本:python diagnose_mcp.py

4) 数据存储(最简可跑通)

用本地文件 data/db.json(或 sqlite 也行,但 json 更快)模拟教务系统,包含:

  • courses[]:用户报名/订单信息(含手机号后四位)
  • slots[]:可约档期(老师、内容、容量、已约)
  • requests[]:调班申请记录(状态、时间戳、原因)

> 只要能支持“目标满员→推荐替代→核验→提交→待审核/成功”闭环即可。


5) Tool 设计(严格按下面 schema)

Tool 1:query_available_slots(简化入参)

name:query_available_slots
用途:按日期查询目标课程是否可约;不可约时返回同课程的替代日期

Input (JSON)```json
{
"course_name": "string",
"original_date": "YYYY-MM-DD",
"target_date": "YYYY-MM-DD"
}


**Output (JSON)**```json
{
"status": "ok",
"requested": {
"is_available": false,
"reason": "FULL|NOT_FOUND|AVAILABLE",
"requested_date": "YYYY-MM-DD"
},
"alternatives": [
{
"slot_id": "string",
"time": "YYYY-MM-DD HH:mm",
"teacher": "string",
"content": "string",
"capacity_left": 3,
"location": "string",
"match": { "same_teacher": true, "same_content": true }
}
]
}

核心逻辑

  • 按课程名匹配课程/档期
  • 只看日期(同一天任意时间),满员则给同课程替代日期,返回最多 3 个,按日期临近排序

Tool 2:submit_schedule_change(简化入参)

name:submit_schedule_change
用途:按学生姓名 + 目标日期提交调班申请(默认返回待审核 180 秒)

Input (JSON)```json
{
"student_name": "string",
"target_date": "YYYY-MM-DD"
}


**Output (JSON)**```json
{
"status": "ok",
"result": "PENDING_AUDIT|SUCCESS|FAILED",
"message": "string",
"audit": { "eta_seconds": 180 },
"updated_schedule": {
"time": "YYYY-MM-DD HH:mm",
"teacher": "string",
"location": "string"
}
}

核心逻辑

  • 通过学生姓名匹配课程
  • 在目标日期匹配同课程、仍有容量的档期;否则 FAILED + SLOT_NOT_FOUND_OR_FULL
  • 默认 PENDING_AUDIT(eta=180),环境变量 SCHEDULE_DIRECT_SUCCESS=true 时直接 SUCCESS

6) 服务结构(建议)```

schedule-shift-mcp/
app.py # FastAPI + MCP 挂载
mcp_server.py # FastMCP tools 定义
storage.py # 读写 data/db.json
data/db.json
pyproject.toml
README.md


### 需要实现的 HTTP 挂载方式

* 让 MCP 作为 ASGI app 挂在 FastAPI 下(路径 `/mcp` 或 `/mcp/`)
* 注意 lifespan 合并(FastMCP 文档建议传递 lifespan) (gofastmcp.com)

---

## 7) 验收标准(跑通即可)

1. 本地启动后,访问 `/health` 返回 `OK` (gofastmcp.com)
2. MCP 客户端能发现 2 个 tools
3. 调用 `query_available_slots`:

* 目标满员时能返回至少 1 个替代档期
4. 调用 `submit_schedule_change`:

* 后四位不匹配 → FAILED
* 匹配 → PENDING_AUDIT(eta=180)或 SUCCESS
5. `data/db.json` 的 `requests[]` 有新增记录

---

## 8) 录入到你的系统(HTTP MCP 插件)

你系统里只要支持 **Streamable HTTP**,通常配置就是“URL + 可选 headers”。MCP 的 HTTP(streamable-http)客户端一般用形如 `http://localhost:8000/mcp` 的 URL。 (LangChain Docs)

**示例(通用)**```json
{
"name": "schedule-shift",
"type": "streamable-http",
"url": "http://localhost:8000/mcp",
"headers": {}
}

> 如果你的系统界面是“Add MCP Server → HTTP(Streamable HTTP) → URL”,就填上面这个 URL,然后刷新工具列表即可。


9) 具体任务

> 用 Python 实现一个基于 FastMCP 的 MCP Server,使用 Streamable HTTP(/mcp/)对外提供两个 tools:query_available_slots 和 submit_schedule_change。用 data/db.json 模拟 courses/slots/requests 三类数据,按需求文档的输入输出 schema 实现逻辑(满员给替代、核验后四位、提交返回待审核 180 秒)。提供 /health 路由、README、启动命令、以及如何在客户端用 http://localhost:8000/mcp/ 连接测试。


常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Schedule Shift MCP 怎么安装?

在客户端按下面的安装命令接入:python run_mcp_server.py。装完在客户端配置里引用同一个包或端点。

Schedule Shift MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Schedule Shift MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Schedule Shift MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Schedule Shift MCP 能提供哪些能力?

资料显示能力标签包括 HTTP服务、Python、FastAPI、本地部署。具体工具清单以官方文档为准。

Schedule Shift MCP 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Schedule Shift MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。