IOBS MCP Server — 手术室 AI 设备控制平台

通过自然语言控制手术床和 C 臂。Claude Desktop 通过 MCP 协议调用设备控制工具，Mock 后端模拟硬件行为，前端 3D 实时可视化。

架构

┌─────────────────┐     MCP (stdio)     ┌──────────────────┐
│  Claude Desktop  │ ◄──────────────────► │  MCP Server       │
│  (自然语言交互)    │                     │  8 个工具          │
└─────────────────┘                     └────────┬─────────┘
                                                 │ HTTP + WS
                                                 ▼
┌─────────────────┐     Vite Proxy       ┌──────────────────┐
│  iobs-unified-app│ ◄──────────────────► │  Mock Backend     │
│  (React 3D 前端)  │                     │  (Express:18011)  │
└─────────────────┘                     └──────────────────┘

开始

npm install
npm run dev

连接到 iobs-unified-app 前端

把你前端的 vite.config.ts 里的代理目标指向 localhost:18011：

// vite.config.ts — 修改一行
'/iobs-api': {
  target: 'http://localhost:18011',  // 原本是 192.168.1.200:18011
  changeOrigin: true,
},

然后启动前端 npm run dev，3D 场景会显示 Mock 后端提供的设备状态。

连接到 Claude Desktop

1. 编译项目：npm run build
2. 找到 Claude Desktop 配置文件：
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
3. 添加配置后重启 Claude Desktop：

{
  "mcpServers": {
    "iobs-surgical": {
      "command": "node",
      "args": ["D:/compilation tool/Yiming/operating table/iobs-mcp-server/dist/index.js"]
    }
  }
}

MCP 工具列表

工具	说明
get_device_state	获取手术床 10 关节 + C 臂 4 关节 + 模式 + 急停
list_joints	列所有可控关节、物理范围、可用体位预设
move_bed_joint	调整手术床指定关节（目标值或增量）
move_carm_joint	调整 C 臂指定关节
apply_bed_preset	一键应用手术体位（平卧位/截石位/沙滩椅位等 7 种）
set_carm_mode	C 臂模式：1=同步 / -1=镜像 / 0=脱离
emergency_stop	🚨 紧急停止所有设备
reset_emergency	解除急停

演示场景

1. 查询设备状态

"手术室现在什么状态？"

2. 调整手术床

"把手术床升高到 800mm，背板抬起来 30 度"

3. 应用手术体位

"病人要做腹腔镜，给我调成 Trendelenburg 位"

4. C 臂控制

"C 臂旋转 45 度，高度降到 320"

5. 紧急停止

"紧急停止！"

6. 完整手术准备

"把床放平，C 臂切换到同步模式，调到沙滩椅位"

API 端点

Mock 后端完整实现了 IOBS API 协议，兼容 iobs-unified-app 前端：

• GET /iobs-api/health
• GET /iobs-api/get_pos?version=1.0
• GET /iobs-api/get_space?version=1.0
• GET /iobs-api/set_joint_move?version=1.0&device=...&joint=...&speed=...
• GET /iobs-api/get_status?version=1.0 — 手术体位预设
• GET /iobs-api/get_c_arm_mode?version=1.0
• POST /iobs-api/set_stop?version=1.0
• WebSocket /ws — 实时状态推送

技术栈

• MCP SDK: @modelcontextprotocol/sdk ^1.0
• Mock Backend: Express + ws + in-memory state
• Runtime: Node.js 18+ (ESM)
• Dev: tsx + TypeScript 5.9

项目结构

src/
├── index.ts              # 入口
├── mock-server/
│   ├── index.ts          # Express 启动
│   ├── device-state.ts   # 设备状态存储 + 约束
│   └── routes.ts         # REST + WebSocket 路由
└── mcp-server/
    ├── index.ts          # MCP Server (stdio)
    ├── tools.ts          # 8 个 Tool 定义
    └── handlers.ts       # Tool 执行逻辑