Ada MCP

AdaMCP-AdaEngine的MCP服务器

 

AdaMCP 将实时AdaEngine应用程序作为MCP服务器公开。它是为检查优先的工作流程而构建的：世界/实体/资源自检、渲染捕获和AdaUI树检查，以及一小部分安全的UI操作。

📚 检查 文档 了解更多

当前平台支持

重要的区别是：

• MCP客户端可以生活在任何地方，并通过HTTP或stdio连接。
• 主机运行时现在建立在更广泛的苹果表面上，而 stdio 仍然主要是本地主机传输，HTTP是主要的跨设备选项。

你得到了什么🌸

• 😳 世界、实体、组件、资源和资产检查。
• 📸 实时渲染输出的屏幕截图。
• 💉 AdaUI检查工具，如 ui.list_windows, ui.get_tree, ui.get_node, ui.find_nodes, ui.capture_node_screenshot，以及 ui.hit_test.
• 🧑‍🏫 AdaUI诊断和安全操作，如焦点遍历、确定性点击和滚动到节点。
• 📦 MCP资源 ada://...，包括 ada://ui/windows, ada://ui/window/{id}, ada://ui/tree/{id}，以及 ada://ui/node/{windowId}/{nodeRef}.

嵌入AdaEngine应用程序⚒️

在包发布之前，将其添加为本地SwiftPM依赖项：

dependencies: [
    .package(url: "https://github.com/AdaEngine/AdaMCP.git", branch: "main")
]

然后将插件添加到您的应用程序中：

import AdaEngine
import AdaMCPPlugin

@main
struct ExampleApp: App {
    var body: some AppScene {
        WindowGroup {
            RootView()
        }
        .addPlugins(
            MCPPlugin(configuration: .init(
                enableHTTP: true,
                enableStdio: true,
                host: "127.0.0.1",
                port: 2510,
                endpoint: "/mcp",
                serverName: "example-app",
                serverVersion: "0.1.0",
                instructions: "Inspect the live AdaEngine runtime."
            ))
        )
    }
}

AdaUI表面

AdaUI支持是有意先检查。主要流程为：

1. 定位窗口或节点。
2. 检查活动树和布局诊断。
3. 应用有限的、确定性的操作。
4. 重新读取树或诊断以验证结果。

外部调用者应通过以下方式定位节点 accessibilityIdentifier. ui.find_nodes 也可以按以下方式搜索 nodeType 或 viewType，例如定位所有滚动视图。 runtimeId 作为会话本地助手在有效载荷中返回，但它不打算成为持久合约。