Um Bus MCP

📘 嗯，公共汽车mcp

这是一个用于UM校园环路总线服务和相关信息的MPC服务器，可以与支持MCP的各种LLM客户端一起使用，作为UM教职员工和学生LLM助理聊天机器人的一部分。

______________________________________________________________________

📋 目录

• 关于
• 特性
• 入门指南

- 先决条件 - 安装

• 用法

______________________________________________________________________

🧐 关于

对您的项目进行深入的概述。解释它解决的问题、背后的动机以及任何其他相关细节。

______________________________________________________________________

🚀 特性

• 乘坐UM Campus Loop穿梭巴士的当前和下一站
• 获取下一班UM校园环线穿梭巴士的时间
• 在台风特殊天气期间，获得UM校园环线穿梭巴士的特别安排
• 获取UM Campus Loop穿梭巴士的时刻表图片
• 获取UM Campus Loop穿梭巴士的路线图
• 获取UM Campus Loop穿梭巴士的用户说明

______________________________________________________________________

🛠️ 入门指南

先决条件

列出运行项目所需的任何软件、库或工具。

Python>=3.10 fastmcp>=0.1.0 crawl4ai>=0.1.0 请求>=2.31.0 目标>=3.9.0 美容组4>=4.12.0

安装

只需使用pip intall-r requirements.txt安装所需的软件包

______________________________________________________________________

💻 用法

本项目提供了一个MCP（多客户端协议）服务器，用于查询UM校园环路穿梭巴士信息。以下是如何使用它：

1.启动MCP服务器

运行主Python文件以启动MCP服务器：

python um_bus_mcp.py

2.可用命令

服务器提供多种工具和资源用于查询总线信息：

工具：

1. get_bus_is_active()

- 检查总线服务当前是否处于活动状态 - 返回服务可用性的状态和消息

1. get_bus_next_run()

- 获取下一班公交车的时间 - 返回下一次运行的状态、时间和消息

1. get_bus_location()

- 追踪巴士的当前位置 - 返回公交车牌号、当前站点和下一站点

资源：

1. image://bus-timetable

- 检索公交车时刻表图像 - 返回时间表的base64编码图像

1. image://bus-route

- 检索公交线路图 - 返回路由的base64编码图像

1. text://bus-user-note

- 获取重要的用户注释和指南 - 返回包含总线使用规则的文本

1. text://bus-typhoon-arrangement

- 台风期间获得特别安排 - 返回包含台风相关服务信息的文本

3.示例用法

以下是您可以对MCP服务器进行的一些示例查询：

# Check if bus is active
response = await mcp.call('get_bus_is_active')
print(f"Bus Status: {response['status']}")
print(f"Message: {response['message']}")

# Get next bus run time
next_run = await mcp.call('get_bus_next_run')
print(f"Next Run Status: {next_run['status']}")
if 'time' in next_run:
    print(f"Next Run Time: {next_run['time']}")

# Get bus location
location = await mcp.call('get_bus_location')
print(f"Bus Plate: {location['plate']}")
print(f"Current Stop: {location['current_stop']}")
print(f"Next Stop: {location['next_stop']}")

# Get timetable image
img_data = await mcp.call('image://bus-timetable')
# The image data is in base64 format and can be decoded and displayed

# Get user notes
guidelines = await mcp.call('text://bus-user-note')
print("Bus Usage Guidelines:")
print(guidelines['data'])

4.整合

您可以将此MCP服务器与支持MCP协议的任何客户端集成。服务器提供有关UM校园环路穿梭巴士服务的实时信息，包括：

• 服务状态
• 下次运行时间
• 当前位置跟踪
• 时间表和路线信息
• 使用指南和特殊安排

通过抓取UM Campus Loop官方网站实时更新信息，网址为https://campusloop.cmdo.um.edu.mo

______________________________________________________________________