Android-Preference-Editor MCP Server

Overview

The Android-Preference-Editor MCP Server is a natural language interface designed for agentic applications to edit Android user preferences during app development. The implementation is based on the Android Preference Editor library. This server integrates seamlessly with MCP (Model Context Protocol) clients, enabling AI-driven workflows during Android app development. Using this MCP, you can give instructions like:

• "Toggle the isVisited user preference"
• "List the connected devices"
• "What apps are installed on device?"
• "Show me all the user preferences in the app"
• "Add a lastTimeStamp user preference with the value of the current milliseconds since epoch"

Tools

Demo

See more demo screenshots here

Requirements

• Android adb installed on the host system.

Integration with Claude Desktop

You can configure Claude Desktop to use this MCP server by adding the following in the claude_desktop_config.json configuration file.

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

Troubleshooting

You can troubleshoot problems by tailing the log file:

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

Integration with VS Code

To use the server with VS Code, you need to:

1. Enable the agent mode tools. Add the following to your settings.json:

{
  "chat.agent.enabled": true
}

1. Add the MCP Server configuration to your mcp.json or settings.json:

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

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

For more information, see the VS Code documentation.

Installation

# Clone the repository
git clone https://github.com/charlesmuchene/pref-editor-mcp-server.git
cd pref-editor-mcp-server

# Install dependencies and build
npm install

Testing

You can use the MCP Inspector for visual debugging of this MCP Server.

npx @modelcontextprotocol/inspector npm run dev

License

See LICENSE

Contact

For questions or support, reach out via GitHub Issues.

Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!