mcpField
S
Shipvo

Shipvo

远程服务
shipvo.dev开发工具2今天更新
代码仓库访问官网

关于 Shipvo

Shipvo MCP 让 AI Agent 在模拟手机中操作 Shipvo React Native 应用，包括查看屏幕和执行设备交互。它还提供所有者工具，用于更改应用内容、价格和优惠。

主要功能

  1. 01读取无障碍树屏幕内容
  2. 02点击、输入、滚动和导航
  3. 03截取屏幕并查看设备日志
  4. 04模拟设备状态和通知
  5. 05通过所有者工具更改内容和优惠

适用场景

  1. 01无需实体手机测试应用流程
  2. 02检查权限和支付提示
  3. 03查看应用发送的后端请求
  4. 04向手机发布内容或价格变更

MCP 相关

向 MCP 客户端提供应用、设备、通知和所有者工具。可在本地或通过 Streamable HTTP 运行；远程请求需要有效密钥。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://sim.shipvo.dev/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址
Streamable HTTPhttps://sim.shipvo.dev/mcp需要授权
安装包
npm@shipvo/mcp0.0.6

工具

详细介绍

@shipvo/mcp

让 AI Agent（Claude、Cursor、Claude Code、PiPilot……）无需手机即可使用 Shipvo 应用：打开应用，以无障碍树的形式读取屏幕，点击、输入、滚动、返回、截图，并读取应用发送到后端的内容。此外还有所有者 API：更改内容、价格和优惠，并发布到每部手机。

{ "mcpServers": { "shipvo": {
  "command": "npx", "args": ["-y", "@shipvo/mcp"],
  "env": { "PN_SIM": "http://localhost:4545", "PN_OWNER_TOKEN": "…optional…" } } } }

先启动模拟器（在应用中运行 shipvo sim）。托管版本无需本地设置：{ "url": "https://<host>/mcp/<key>" }。

工具：list_apps、open_app、screen、tap、type、scroll、back、screenshot、set_device、push_notification、notifications、open_notification、device_log、end_session、owner_describe、owner_command。

无需手机即可使用原生功能：模拟设备（参见 @shipvo/device）会在树中以真实对话框的形式显示权限对话框、相机、指纹提示、支付提示、通知横幅和分享面板；set_device 可设置手机的状态（位置、视野中的条形码、指纹是否匹配、支付是否获批、网络是否关闭）。

模拟器只显示手机上会显示的内容：水平栏会列出可见项目，因此 Agent 会像在设备上一样滑动该栏（使用该栏的 ref 执行 scroll right）。与真实 Android 模拟器和 iPhone 模拟器的对照结果请参见 docs/parity-results.md。

远程（Streamable HTTP）

在模拟器运行的环境中启动服务，并将其置于 HTTPS 之后（Cloudflare Tunnel 即可）：

PN_API_KEYS="key-for-claude,key-for-pipilot" shipvo-mcp --http 8787

客户端使用 URL 连接，而不是使用命令：

{ "mcpServers": { "shipvo": { "url": "https://sim.shipvo.dev/mcp", "headers": { "Authorization": "Bearer key-for-claude" } } } }

每个客户端连接都有自己的 MCP 会话；每次 open_app 都会分配一部独立手机。无有效密钥的请求将被拒绝。托管版本 sim.shipvo.dev 将为每个账户按作用域（test、owner、read）发放密钥。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。