PhonePi MCP

一个允许您通过喜爱的AI应用程序控制手机的MCP服务器！

预备条件

您需要在手机上安装PhonePi MCP应用。请访问PhonePi MCP获取安装说明。

MCP服务器设置

只需按照以下步骤在您喜爱的AI应用程序（如Claude、Cline或Cursor）中设置服务器即可。

安装

全局安装包：

npm install -g phonepi-mcp

或者直接使用npx运行：

npx phonepi-mcp

设置

只需向您的AI应用程序添加以下MCP配置：

{
  "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