aixautobotaixautobot
写新云 aixautobot 文档

方式 C:MCP 与 AI

MCP server、内置 Skill 给 AI 上手

让 AI(Claude Desktop / Cursor 等)通过 Model Context Protocol 直接操控设备。

CLI

aixautobot mcp serve                 # stdio(Claude Desktop / Cursor),默认 name "aixautobot"
aixautobot mcp serve --backend http://localhost:3000 --name aixautobot

Claude Desktop / Cursor 配置:

{ "mcpServers": { "aixautobot": { "command": "/abs/path/to/aixautobot", "args": ["mcp", "serve"] } } }

MCP server 会暴露:resource skill://aixautobot 与 tool get_skill(均返回内置 skill),以及 prompt generate_flow / analyze_ui。AI 客户端连上后可先读 skill 了解接口与脚本写法。

SSE transport 当前为占位,请使用 stdio。

嵌入自定义 MCP server

use aixautosdk::core::mcp::{McpServer, StdioTransport};

#[tokio::main]
async fn main() -> aixautosdk::core::Result<()> {
    McpServer::builder()
        .name("my-automation-mcp")
        .version(env!("CARGO_PKG_VERSION"))
        .transport(Box::new(StdioTransport::new()))
        .build()?
        .serve()
        .await
}

内置 Skill

SDK 二进制内置一份权威 skill 文档(编进二进制),讲解设备接口、Flow JSON 脚本、scriptlet 写法、MCP 用法,让任意 AI 快速上手。三种获取途径:

途径用法
CLIaixautobot skill(打印 markdown,可重定向到文件供 AI 读)
MCP resource读取 URI skill://aixautobotresources/list 可见)
MCP tool调用 get_skill(返回同一份 markdown)

库内引用:

let md: &str = aixautosdk::skill::SKILL_MD;   // 或 aixautosdk::skill::skill_markdown()
let uri = aixautosdk::skill::SKILL_URI;       // "skill://aixautobot"

skill 内容以 sdk/aixautosdk/resources/aixautobot-sdk-skill.md 为单一来源;改接口/脚本格式时同步更新该文件,三种途径自动同步。