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

PhonePi MCP

お気に入りの AI アプリからスマートフォンを操作できる MCP サーバーです！

前提条件

スマートフォンに 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 プロトコルによるスマートフォンのリモート操作
• バッテリー残量の取得
• SMS メッセージの送信
• 電話の発信
• ビープ音を鳴らしてスマートフォンを探す
• タイマーとアラームの設定
• テキストのクリップボードへのコピー
• 連絡先の管理
• 通知の送信

開発

パッケージをビルドします。

npm run build

開発モードで実行します。

npm run dev

ライセンス

MIT