2.1 KiB
VPS-Commander MCP 接入与能力
1. 当前状态
MCP JSON-RPC 2.0；serverInfo 1.2.0；initialize protocolVersion 2024-11-05。 远程 HTTP 当前是 legacy HTTP+SSE；本地是 stdio。Streamable HTTP 是后续演进方向。
2. 11 个工具
| Tool | Risk | 作用 |
|---|---|---|
| list_devices | Low | 设备列表 |
| exec_command | High | Shell |
| read_file | Low | 文件读取 |
| read_multiple_files | Low | 批量读取 |
| create_directory | Medium | 创建目录 |
| move_file | Medium | 移动/重命名 |
| list_processes | Low | 进程观察 |
| edit_block | Medium | 原子文本修改 |
| write_file | Medium | 文件写入 |
| list_agent_mcp | Low | Agent MCP 列表 |
| call_agent_mcp | Medium | 调度 Agent MCP |
3. 远程接入
GET /mcp/sse → sessionId → POST /mcp/message?sessionId=。 请求头：Authorization: Bearer <API_KEY>。 HTTP+SSE 仅作为兼容层，不作为未来新能力的主要 transport。
4. stdio
启动 vps-commander-mcp-stdio，参数 -hub -key <API_KEY>。 API Key 不提交到仓库。
5. 参数
exec_command：device、command、workdir、timeout。 read_file：device、path、offset、limit；默认 256 KiB，最大 1 MiB。 read_multiple_files：device、paths、limit；paths 最多 32 个。 create_directory：device、path。 move_file：device、source、destination。 list_processes：device。 edit_block：device、path、old_text、new_text；old_text 必须唯一匹配。 write_file：device、path、content。 list_agent_mcp：device。 call_agent_mcp：device、server、tool、arguments。
6. 安全链路
MCP Client → Bearer auth → JSON-RPC → tool mapping → authenticated device → Policy Snapshot → Tool Registry → allow/deny → Local/Agent → audit。 未知设备不得因为 GlobalRisk 而获得 High。
7. Agent MCP
Hub 发现远程 Agent MCP service；客户端不直连 Agent。 Hub 负责 device authentication、risk gate、routing、audit。
8. 下一步
Streamable HTTP、SSE fallback、capability-based advertisement、Principal audit context、显式 operation/session handle。