MCP 服务器 Quick Start 指南

简介

MCP（主控程序）服务器是 Blade Runner 项目的核心组件，负责管理 CCP、站点和 LED 控制器的连接并协调整个系统的运行。

基本功能

• 管理多个并发连接（CCP、站点和 LED 控制器）
• 监听 UDP 端口 2001
• 记录事件和系统状态
• 跟踪 Blade Runner 位置
• 控制 Blade Runner 速度

校准流程

当 Blade Runner 被放置在轨道上时，系统会自动执行校准：

1. 首个 BR 会撞击第一个站点，确定当前位置
2. 第二个 BR 进入轨道，接收确认信息
3. 所有红外传感器保持开启，直至所有 BR 就位
4. 获取所有 BR 及其站点位置后，正式会话开始

基本使用代码示例

# 初始化 MCP 服务器
mcp_server = MCPServer(port=2001)
mcp_server.start()

# 发送速度控制命令
mcp_server.send_command(ccp_id, "FAST")
mcp_server.send_command(ccp_id, "SLOW")
mcp_server.send_command(ccp_id, "STOP")

# 接收状态更新
@mcp_server.on_status_update
def handle_status(device_id, status):
    print(f"收到来自 {device_id} 的状态更新: {status}")

当前功能状态

完全实现 (100%)

• 连接管理
• 事件和状态记录

部分实现

• 通信初始化 (50%)
• Blade Runner 位置跟踪 (40%)
• Blade Runner 速度管理 (30%)
• 状态更新处理 (40%)

待实现

• 碰撞防止系统
• 站点停车协调
• 门控制
• LED 控制
• 错误处理和重连
• 系统范围操作

下一步开发重点

1. 完善初始化序列
2. 实现实时轨道地图
3. 增强速度控制逻辑
4. 开发高级状态处理
5. 实现错误处理与重连机制

---

详细开发计划请参考完整文档。有问题请联系项目管理团队。