PhonePi MCP: Turn your phone into a toolbox for AI assistants using Model Context Protocol

PhonePi MCP

一款 MCP 服务，可让你通过喜爱的 AI 应用控制手机！

前置条件

你需要在手机上设置 PhonePi MCP 应用。请访问 PhonePi MCP 查看说明。

MCP 服务设置

只需按照以下步骤，在 Claude、Cline 或 Cursor 等喜爱的 AI 应用中设置服务。

安装

全局安装软件包：

npm install -g phonepi-mcp

或使用 npx 直接运行：

npx phonepi-mcp

设置

只需将以下 MCP 配置添加到你的 AI 应用中：

{
  "mcpServers": {
    "phonepi-mcp": {
      "command": "npx",
      "args": [
        "phonepi-mcp",
        "start"
      ]
    }
  }
}

使用上述设置保存文件。除了移动应用之外，设置只需完成这些步骤。

连接

• 确保手机和桌面设备处于同一网络。建议使用 Tailscale 之类的工具以方便连接，但这不是必需的。
• 在配套移动应用中输入本地 IP 地址和端口（11041），以连接到服务。
• 一切正确连接后，就可以让 AI 助手帮你处理各种事情了！例如，试着让它向手机发送一条测试通知。

MCP 服务管理 CLI（可选）

独立使用

上述设置说明已涵盖如何将其与 Cline、Claude Desktop 等 MCP 客户端搭配使用。

此外，PhonePi MCP 还提供独立的命令行界面，让你可以在客户端之外管理 MCP 服务。

命令

• start：启动 MCP 服务
• stop：停止正在运行的 MCP 服务
• status：检查 MCP 服务是否正在运行
• restart：重启 MCP 服务

启动服务

phonepi-mcp start

选项：

• -p, --port <port>：指定服务运行端口（默认：11041）
• -b, --background：在后台运行服务

示例：

phonepi-mcp start -p 8080 -b

检查服务状态

phonepi-mcp status

停止服务

phonepi-mcp stop

重启服务

phonepi-mcp restart

选项：

• -p, --port <port>：指定服务运行端口（默认：11041）
• -b, --background：在后台运行服务

连接手机

1. 在手机上安装 PhonePi MCP 应用
2. 使用 phonepi-mcp start 在电脑上启动服务
3. 在应用中连接到电脑的 IP 地址和端口（默认 11041）

功能

• 通过 MCP 协议远程控制手机
• 获取电池电量
• 发送短信
• 拨打电话
• 让手机发出哔声以便查找
• 设置计时器和闹钟
• 将文本复制到剪贴板
• 管理联系人
• 发送通知

开发

构建软件包：

npm run build

以开发模式运行：

npm run dev

许可证

MIT