关键词

手机控制AI助手移动设备自动化上下文协议智能设备管理

项目简介

PhonePi MCP (Model Context Protocol) 旨在将您的手机转变为AI助手的强大工具箱。通过这款MCP服务器和配套应用，您可以使用支持MCP协议的AI应用（如Cursor、Claude Desktop等）以自然语言指令远程管理和控制您的手机。它提供了一整套工具和API，使您能够以编程方式与移动设备进行交互，扩展AI应用的功能边界。

主要功能点

  • 联系人和消息管理：读取和管理手机中的联系人信息和短信消息。
  • 片段和笔记管理：创建、检索、更新和删除笔记、代码片段等。
  • 设备设置控制：控制手机的各项设置，如勿扰模式、飞行模式等（具体功能取决于手机应用实现）。
  • 发送短信和拨打电话：通过自然语言指令发送短信和发起电话呼叫。
  • 内容分享：跨应用分享文本、链接等内容。
  • 电池状态监控：获取手机电池电量信息。
  • 定时器和提醒设置：设置定时器和提醒事项。
  • 查找手机：通过音频警报帮助定位手机。
  • 剪贴板操作：复制文本到手机剪贴板。
  • 通知管理：发送手机通知消息。

安装步骤

  1. 安装 PhonePi MCP 命令行工具 (客户端和服务器端都包含在此工具中)

    打开终端或命令提示符，运行以下命令进行全局安装：

    npm install -g phonepi-mcp

服务器配置

PhonePi MCP 服务器旨在与 MCP 客户端配合使用。以下是在 MCP 客户端中配置连接 PhonePi MCP 服务器的示例配置信息 (JSON 格式)。请注意，您无需手动配置服务器，而是将以下信息填入 MCP 客户端的服务器配置中，以便客户端能够找到并连接到 PhonePi MCP 服务器。

{
  "serverName": "PhonePi-MCP",
  "command": "npx",
  "args": [
    "phonepi-mcp",
    "start"
  ],
  "description": "PhonePi MCP Server",
  "capabilities": {
    "tools": true,
    "prompts": false,
    "resources": false
  },
  "transport": "stdio"
}

配置参数说明:

  • 'serverName': 服务器名称，可以自定义，用于在客户端中标识该服务器连接。
  • 'command': 启动服务器的命令，这里使用 'npx' 来执行 'phonepi-mcp' 包。
  • 'args': 传递给启动命令的参数，'start' 参数指示 'phonepi-mcp' 启动服务器。
  • 'description': 服务器描述，用于在客户端界面显示服务器的用途或说明。
  • 'capabilities': 声明服务器具备的能力，'tools: true' 表示该服务器支持工具调用。
  • 'transport': 指定客户端与服务器通信的传输协议，'stdio' 表示使用标准输入输出流进行通信。

可选的服务器启动参数 (可以在 'args' 数组中添加):

  • '-p, --port <port>': 指定服务器监听的端口号，默认为 '11041'。例如 '["start", "--port", "12345"]' 将服务器端口设置为 '12345'。
  • '-b, --background': 以后台模式运行服务器。在后台模式下，服务器会在独立的进程中运行，不会占用终端窗口。如果省略此参数，服务器将在前台运行，并占用终端窗口。

基本使用方法

  1. 启动 PhonePi MCP 服务器

    在安装 'phonepi-mcp' 的终端或命令提示符中，运行以下命令启动服务器：

    npx phonepi-mcp start

    如果一切正常，您将看到服务器成功启动并监听端口 '11041' (或您指定的端口) 的信息。

  2. 配置 MCP 客户端

    打开您使用的 MCP 客户端 (如 Cursor 或 Claude Desktop)，在客户端的设置或配置中，添加一个新的 MCP 服务器连接，并将上面提供的 JSON 配置信息粘贴到相应的配置项中。确保客户端配置的传输协议 ('transport') 与服务器实际使用的协议一致 (这里是 'stdio')。

  3. 使用自然语言指令控制手机

    在 MCP 客户端中，您可以使用自然语言指令与 PhonePi MCP 服务器进行交互。例如，您可以尝试以下指令：

    • "Get battery level" (获取电池电量)
    • "Send SMS to 138xxxxxxxx message content" (发送短信)
    • "Create a note titled 'Shopping List' with content 'Milk, Eggs, Bread'" (创建购物清单笔记)
    • "Find my phone" (查找手机)

    AI助手会解析您的指令，调用 PhonePi MCP 服务器提供的工具来执行相应的手机操作，并将结果返回给您。

客户端命令行工具使用 (phonepi-cli):

仓库也包含了一个名为 'phonepi-cli' 的命令行客户端工具，用于与 PhonePi MCP 服务器交互。

  • 聊天模式: 启动交互式聊天会话，可以连续提问和接收手机的响应。

    phonepi chat --key <Your_Anthropic_API_Key>

    请替换 '<Your_Anthropic_API_Key>' 为您的 Anthropic API 密钥。您也可以设置环境变量 'ANTHROPIC_API_KEY' 或在 '.env' 文件中配置 API 密钥。

  • 单次查询模式: 发送单个查询并获取响应。

    phonepi query "Get battery level" --key <Your_Anthropic_API_Key>

    同样需要提供 Anthropic API 密钥。

    注意: 'phonepi-cli' 客户端需要 Anthropic API 密钥才能工作，因为它使用 Anthropic 的 Claude 模型来处理自然语言指令并调用 MCP 工具。

总结

PhonePi MCP 提供了一个桥梁，连接了 AI 应用和您的手机，使您能够通过自然语言指令方便地控制手机的各项功能，极大地提升了移动设备的智能化水平和使用效率。

信息

分类

桌面与硬件

访问项目