Sidecar Onestep Clawhub

Control SidecarOneStep - A macOS Sidecar enhancement tool. One-click iPad connection, remote control, automation integration. Manage devices via MCP integrat...

Security Scan

The skill's requests and instructions are consistent with its stated purpose (a macOS Sidecar helper that integrates with mcporter/MCP); there are no unexplained credentials, odd install hosts, or instructions to access unrelated system data—though the web-console feature and MCP/stdio control are powerful and should be used with caution.

Purpose & Capability

Name/description match the required artifacts: mcporter is declared and used for MCP commands; the app path /Applications/SidecarOneStep.app is referenced and required. The declared binaries and app requirement are proportionate to a Sidecar/MCP integration skill.

Instruction Scope

SKILL.md instructs the agent to download a GitHub release, enable MCP (stdio) in the app, configure mcporter, and call specific MCP tools (connect, disconnect, start/stop HTTP server, get_logs, etc.). These actions are within the skill's claimed scope. Note: starting the HTTP control server and enabling MCP gives remote/local clients programmatic control over Sidecar behavior — this is expected for the feature but is a privileged capability the user should understand.

Install Mechanism

There is no opaque installer pulled from an untrusted host. Download URLs point to GitHub Releases (a standard release host). No extract-from-arbitrary-URL or shorteners are used. The repository also includes publish scripts (for ClawHub) but they are unrelated to runtime behavior.

Credentials

The skill declares no environment variables or credentials. The runtime instructions only use the mcporter binary and the installed app path — both justified by the functionality. No unrelated secrets or config paths are requested.

Persistence & Privilege

The skill is not force-included (always:false) and does not request persistent elevated privileges. It does not modify other skills' configs. Autonomous invocation is allowed (default) but not accompanied by other high-risk indicators.

Assessment

This skill appears to be what it says: a Sidecar enhancement that uses mcporter/MCP. Before installing, verify the SidecarOneStep binary you're downloading (check the GitHub repo/release page and signatures if available), ensure you trust the app author, and be aware that enabling MCP (stdio) and starting the HTTP control server exposes a programmatic control surface — only enable that on trusted networks and consider firewall rules to avoid exposing the web console to the internet. Confirm mcporter is the legitimate client you expect, and review the app's behavior (permissions, network listeners) after installation.

SidecarOneStep / 随航一步

English | 中文

---

<a name="english"></a>

Overview

SidecarOneStep is a powerful macOS Sidecar enhancement tool that makes managing iPad connections effortless. Through MCP (Model Context Protocol) integration, AI assistants like Claude, Cursor, and OpenClaw can directly control your Sidecar connections.

📋 System Requirements

Platform	Version	Notes
macOS	12.0+ (Monterey)	Required for Sidecar API
iPadOS	13.0+	Required for Sidecar support
Hardware	2018+ iPad models	iPad Pro, iPad Air 3rd gen+, iPad 6th gen+, iPad mini 5th gen+
Tools	mcporter CLI	For MCP integration

⚠️ Prerequisites: Both Mac and iPad must be signed into the same iCloud account with 2FA enabled.

🌟 Key Features

• 🚀 One-Click Connection - Instantly connect/disconnect iPad from menu bar
• 📱 Remote Control - Web console for controlling Sidecar from your phone
• 🔌 Wired Mode - Force wired connection for low-latency stability
• 🛠️ Full Automation - Complete REST API + MCP integration (10 tools)
• 🤖 AI Integration - Let AI assistants manage your connections

📥 Installation

1. Download & Install App

Download the latest version from GitHub Releases:

https://github.com/yi-nology/sidecarOneStep/releases/latest

Or direct download:

curl -L -o SidecarOneStep.dmg https://github.com/yi-nology/sidecarOneStep/releases/download/v1.3.9/SidecarOneStep_Installer.dmg
hdiutil attach SidecarOneStep.dmg
cp -R /Volumes/SidecarOneStep\ Installer/SidecarOneStep.app /Applications/

2. Enable MCP in Settings

1. Open SidecarOneStep
2. Go to "Settings" → "Developer / Integrations"
3. Enable "MCP (stdio)"

3. Configure MCP

# Add SidecarOneStep to mcporter
mcporter config add sidecar-onestep \
  --command /Applications/SidecarOneStep.app/Contents/MacOS/SidecarOneStep \
  --args mcp

# Verify configuration
mcporter list sidecar-onestep

Expected output:

sidecar-onestep — macOS Sidecar 增强工具 (10 tools)

🚀 Quick Start

Prerequisites Check

Before using this skill, ensure:

• SidecarOneStep.app installed in /Applications/
• MCP enabled in app settings (Settings → Developer/Integrations → MCP)
• mcporter configured: mcporter list sidecar-onestep should show the server
• iPad nearby, unlocked, and on same iCloud account

List Available Devices

mcporter call sidecar-onestep.list_devices

Response:

["张易的iPad Pro", "iPad Air"]

Connect Device (Recommended: Async)

# Async connection (non-blocking, recommended)
mcporter call sidecar-onestep.connect_device_async device_name="张易的iPad Pro" wired=true

# Response:
{
  "id": "job_12345",
  "status": "success",
  "result": "张易的iPad Pro",
  "wired": true
}

Disconnect Device

mcporter call sidecar-onestep.disconnect_device device_name="张易的iPad Pro"

Get Status

mcporter call sidecar-onestep.get_status

Response:

{
  "active_device": "张易的iPad Pro",
  "active_wired": true,
  "server_running": true,
  "server_port": 8765
}

🛠️ Available Tools (10)

Tool	Description	Blocking
list_devices	List available Sidecar devices	❌
connect_device	Connect device (synchronous)	⚠️ Yes
connect_device_async	Connect device (async)	❌ Recommended
get_job_status	Query async job status	❌
cancel_job	Cancel pending job	❌
disconnect_device	Disconnect device	❌
start_http_server	Start HTTP control server	❌
stop_http_server	Stop HTTP server	❌
get_status	Get app/connection status	❌
get_logs	Get recent server logs	❌

🔔 Trigger Examples (for AI Assistants)

When a user says any of the following, this skill should be activated:

Example 1: Connect iPad

User: "Connect my iPad"
User: "用有线模式连我的 iPad"

→ AI calls: connect_device_async device_name="<device_name>" wired=true

Example 2: Check Status

User: "Is my iPad connected?"
User: "看看 Sidecar 状态"

→ AI calls: get_status

Example 3: Disconnect

User: "Disconnect iPad"
User: "断开 iPad 连接"

→ AI calls: disconnect_device device_name="<device_name>"

Example 4: Web Console

User: "Start the Sidecar web console"
User: "打开 Sidecar 远程控制台"

→ AI calls: start_http_server port=8765

Example 5: List Devices

User: "Show me available Sidecar devices"
User: "列出可用的 iPad"

→ AI calls: list_devices

🎯 Use Cases

Daily Workflow

# 1. Connect iPad (async, non-blocking)
mcporter call sidecar-onestep.connect_device_async device_name="iPad Pro" wired=true

# 2. Start web console
mcporter call sidecar-onestep.start_http_server port=8765

# 3. Check status
mcporter call sidecar-onestep.get_status

Meeting Mode (Wireless)

# Wireless connection for mobility
mcporter call sidecar-onestep.connect_device_async device_name="iPad Air" wired=false

Automation Integration

# Use in scripts, Shortcuts, Raycast, Alfred, etc.
mcporter call sidecar-onestep.connect_device_async device_name="iPad Pro" wired=true

🤖 AI Assistant Integration

SidecarOneStep works seamlessly with AI assistants:

Natural Language Commands:

• "List my iPad devices" → list_devices
• "Connect to iPad Pro" → connect_device_async
• "Connect iPad with wired mode" → connect_device_async wired=true
• "Disconnect iPad" → disconnect_device
• "Start web console" → start_http_server
• "Check Sidecar status" → get_status

🔧 Troubleshooting

Issue: Device list is empty

Solution:

1. Ensure iPad and Mac use the same iCloud account
2. Ensure iPad supports Sidecar (2018 or later)
3. Ensure iPad is nearby and unlocked
4. Check "System Preferences" → "Sidecar"

Issue: Async connection job not found

Note: In stdio MCP mode, each call creates a new process. Use connect_device_async which now returns the complete status immediately, no need to call get_job_status.

Issue: MCP server not responding

Solution:

1. Verify app is installed: ls /Applications/SidecarOneStep.app
2. Check configuration: mcporter list sidecar-onestep
3. Restart mcporter daemon: mcporter daemon restart

📚 Resources

• 🏠 Website: https://sidecaronestep.app.murphyyi.com/
• 🐙 GitHub: https://github.com/yi-nology/sidecarOneStep
• 📦 Download: https://github.com/yi-nology/sidecarOneStep/releases
• 📖 Documentation: See GitHub README

📄 License

MIT License - Free to use

---

<a name="中文"></a>

概述

SidecarOneStep（随航一步） 是一款强大的 macOS Sidecar 增强工具，让 iPad 连接管理变得轻松简单。通过 MCP（模型上下文协议）集成，Claude、Cursor、OpenClaw 等 AI 助手可以直接控制你的 Sidecar 连接。

📋 系统要求

平台	版本	说明
macOS	12.0+ (Monterey)	Sidecar API 必需
iPadOS	13.0+	Sidecar 支持必需
硬件	2018+ iPad 机型	iPad Pro、iPad Air 第3代+、iPad 第6代+、iPad mini 第5代+
工具	mcporter CLI	用于 MCP 集成

⚠️ 前置条件：Mac 和 iPad 必须登录同一 iCloud 账户并启用双重认证。

🌟 核心功能

• 🚀 一键连接 - 菜单栏即时连接/断开 iPad
• 📱 远程控制 - Web 控制台，手机管理 Sidecar
• 🔌 有线模式 - 强制有线连接，低延迟稳定
• 🛠️ 完整自动化 - 完整 REST API + MCP 集成（10 个工具）
• 🤖 AI 集成 - 让 AI 助手管理你的连接

📥 安装

1. 下载并安装应用

从 GitHub Releases 下载最新版本：

https://github.com/yi-nology/sidecarOneStep/releases/latest

或直接下载：

curl -L -o SidecarOneStep.dmg https://github.com/yi-nology/sidecarOneStep/releases/download/v1.3.9/SidecarOneStep_Installer.dmg
hdiutil attach SidecarOneStep.dmg
cp -R /Volumes/SidecarOneStep\ Installer/SidecarOneStep.app /Applications/

2. 在设置中启用 MCP

1. 打开 SidecarOneStep
2. 进入"设置" → "开发/集成"
3. 启用"MCP (stdio)"

3. 配置 MCP

# 将 SidecarOneStep 添加到 mcporter
mcporter config add sidecar-onestep \
  --command /Applications/SidecarOneStep.app/Contents/MacOS/SidecarOneStep \
  --args mcp

# 验证配置
mcporter list sidecar-onestep

预期输出：

sidecar-onestep — macOS Sidecar 增强工具 (10 tools)

🚀 快速开始

前置条件检查

使用此技能前，请确认：

• SidecarOneStep.app 已安装在 /Applications/
• 应用设置中已启用 MCP（设置 → 开发/集成 → MCP）
• mcporter 已配置：mcporter list sidecar-onestep 应显示该服务器
• iPad 在附近、已解锁、使用同一 iCloud 账户

列出可用设备

mcporter call sidecar-onestep.list_devices

响应：

["张易的iPad Pro", "iPad Air"]

连接设备（推荐：异步）

# 异步连接（不阻塞，推荐）
mcporter call sidecar-onestep.connect_device_async device_name="张易的iPad Pro" wired=true

# 响应：
{
  "id": "job_12345",
  "status": "success",
  "result": "张易的iPad Pro",
  "wired": true
}

断开设备

mcporter call sidecar-onestep.disconnect_device device_name="张易的iPad Pro"

获取状态

mcporter call sidecar-onestep.get_status

响应：

{
  "active_device": "张易的iPad Pro",
  "active_wired": true,
  "server_running": true,
  "server_port": 8765
}

🛠️ 可用工具（10 个）

工具	说明	阻塞
list_devices	列出可用 Sidecar 设备	❌
connect_device	连接设备（同步）	⚠️ 是
connect_device_async	连接设备（异步）	❌ 推荐
get_job_status	查询异步任务状态	❌
cancel_job	取消待处理任务	❌
disconnect_device	断开设备	❌
start_http_server	启动 HTTP 控制服务器	❌
stop_http_server	停止 HTTP 服务器	❌
get_status	获取应用/连接状态	❌
get_logs	获取最近服务器日志	❌

🔔 触发示例（AI 助手用）

当用户说以下内容时，应激活此技能：

示例 1：连接 iPad

用户："Connect my iPad"
用户："用有线模式连我的 iPad"

→ AI 调用：connect_device_async device_name="<设备名>" wired=true

示例 2：检查状态

用户："Is my iPad connected?"
用户："看看 Sidecar 状态"

→ AI 调用：get_status

示例 3：断开连接

用户："Disconnect iPad"
用户："断开 iPad 连接"

→ AI 调用：disconnect_device device_name="<设备名>"

示例 4：Web 控制台

用户："Start the Sidecar web console"
用户："打开 Sidecar 远程控制台"

→ AI 调用：start_http_server port=8765

示例 5：列出设备

用户："Show me available Sidecar devices"
用户："列出可用的 iPad"

→ AI 调用：list_devices

🎯 使用场景

每日工作流

# 1. 连接 iPad（异步，不阻塞）
mcporter call sidecar-onestep.connect_device_async device_name="iPad Pro" wired=true

# 2. 启动 Web 控制台
mcporter call sidecar-onestep.start_http_server port=8765

# 3. 查看状态
mcporter call sidecar-onestep.get_status

会议模式（无线）

# 无线连接，方便移动
mcporter call sidecar-onestep.connect_device_async device_name="iPad Air" wired=false

自动化集成

# 在脚本、快捷指令、Raycast、Alfred 等中使用
mcporter call sidecar-onestep.connect_device_async device_name="iPad Pro" wired=true

🤖 AI 助手集成

SidecarOneStep 与 AI 助手无缝协作：

自然语言命令：

• "列出我的 iPad 设备" → list_devices
• "连接 iPad Pro" → connect_device_async
• "用有线模式连接 iPad" → connect_device_async wired=true
• "断开 iPad 连接" → disconnect_device
• "启动 Web 控制台" → start_http_server
• "查看 Sidecar 状态" → get_status

🔧 故障排查

问题：设备列表为空

解决方案：

1. 确认 iPad 和 Mac 使用同一 iCloud 账户
2. 确认 iPad 支持 Sidecar（2018 年及之后）
3. 确认 iPad 在附近并已解锁
4. 检查"系统偏好设置" → "随航"

问题：异步任务状态 not_found

说明： stdio MCP 模式下，每次调用都会创建新进程。connect_device_async 现在会立即返回完整状态，无需调用 get_job_status。

问题：MCP 服务器未响应

解决方案：

1. 确认应用已安装：ls /Applications/SidecarOneStep.app
2. 检查配置：mcporter list sidecar-onestep
3. 重启 mcporter daemon：mcporter daemon restart

📚 资源

• 🏠 官网：https://sidecaronestep.app.murphyyi.com/
• 🐙 GitHub：https://github.com/yi-nology/sidecarOneStep
• 📦 下载：https://github.com/yi-nology/sidecarOneStep/releases
• 📖 文档：查看 GitHub README

📄 许可证

MIT License - 免费使用

---

🎉 Acknowledgments

Created by MurphyYi Skill package by Wednesday (OpenClaw)

If you find this tool helpful, please ⭐️ star the GitHub repository!