Android-Preference-Editor MCP Server

Android Preference Editor MCP Server

概要

Android Preference Editor MCP Server を使って、Android アプリ開発で自然言語の力を活用しましょう。簡単な会話形式のコマンドを使って、ユーザー設定をリアルタイムで簡単に編集できます。手動でファイルを編集する必要はありません。このサーバーは、堅牢な Android Preference Editor ライブラリを基盤としており、MCP（Model Context Protocol）クライアントとシームレスに連携して、AI を活用したワークフローを強化します。

MCP サーバーに、次のように実行したいことを伝えるだけです。

• 「isVisited ユーザー設定を切り替えて」
• 「オンボーディングガイドをオフにして」
• 「すべてのユーザー設定の値を一覧表示して」
• 「現在のエポック時刻を使ってタイムスタンプ設定を作成して」

Android の設定をよりスマートかつ迅速に管理できます。話しかけるだけです！

利用可能なツール

名前	説明
change_preference	既存の設定の値を変更します
delete_preference	既存の設定を削除します
add_preference	名前、値、型を指定して新しい設定を追加します
read_preferences	ファイル内のすべてのユーザー設定を読み取ります
devices	接続されている Android デバイスを一覧表示します
list_apps	デバイスにインストールされているアプリを一覧表示します
list_files	アプリの設定ファイルを一覧表示します

デモ

ユーザー設定の切り替え	利用可能なツール	設定の追加

その他のデモはデモのスクリーンショットディレクトリをご覧ください。

要件

• Android adb（v1.0.41+）
• Node.js 14+ または Docker

インテグレーション

このサーバーは Docker MCP Catalog で利用できます。Docker desktop の MCP toolkit で Pref Editor サーバーを有効にすると、利用可能なすべてのツールにアクセスできます。

Android Studio

MCP 対応クライアントがインストールされていることを前提とします。

次の設定を MCP サーバー設定ファイルに追加してください。たとえば、GitHub Copilot IntelliJ Plugin の場合、設定ファイルは ~/.config/github-copilot/intellij/mcp.json です。

Docker

{
  "servers": {
    "pref-editor": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "charlesmuchene/pref-editor-mcp-server"]
    }
  }
}

npx

{
  "servers": {
    "pref-editor": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@charlesmuchene/pref-editor-mcp-server"]
    }
  }
}

Claude Desktop

このサーバーを /Users/<username>/Library/Application Support/Claude/claude_desktop_config.json 設定ファイルに追加してください。

Docker

{
  "mcpServers": {
    "pref-editor": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "charlesmuchene/pref-editor-mcp-server"]
    }
  }
}

npx

{
  "mcpServers": {
    "pref-editor": {
      "command": "npx",
      "args": ["-y", "@charlesmuchene/pref-editor-mcp-server"]
    }
  }
}

ログファイルを tail すると、問題のトラブルシューティングができます。

tail -f ~/Library/Logs/Claude/mcp-server-pref-editor.log

VS Code

VS Code でサーバーを使用するには、次の操作が必要です。

1. MCP サーバーの設定を mcp.json または settings.json に追加します。

.vscode/mcp.json

{
  "servers": {
    "pref-editor": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@charlesmuchene/pref-editor-mcp-server"]
    }
  }
}

~/Library/Application Support/Code/User/settings.json

{
  "mcp": {
    "pref-editor": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@charlesmuchene/pref-editor-mcp-server"]
    }
  }
}

詳しくは、VS Code のドキュメントをご覧ください。

ローカルでのビルド

このプロジェクトのビルド方法については、DEV.md を参照してください。

テスト

この MCP サーバーの視覚的なデバッグには、MCP Inspector を使用できます。

npx @modelcontextprotocol/inspector npm run start

ライセンス

LICENSE を参照してください。

お問い合わせ

質問やサポートについては、GitHub Issuesからお問い合わせください。

コントリビューション

コミュニティからのコントリビューションを歓迎します！🎉

初めてコントリビューションする方へ： まずは、以下の内容を説明したCONTRIBUTING.mdガイドをお読みください。

• PR の要件とタイトルの形式
• 開発環境のセットアップとワークフロー
• コード品質基準
• ライセンス情報

詳しい開発手順については、DEV.mdをご覧ください。