Android-Preference-Editor MCP Server

Android Preference Editor MCP 服务

概述

借助 Android Preference Editor MCP Server，在 Android 应用开发中释放自然语言的强大能力。使用简单的对话式命令，即可实时轻松编辑用户偏好设置，无需手动编辑文件！此服务基于功能强大的 Android Preference Editor 库构建，可与 MCP（Model Context Protocol）客户端无缝连接，为 AI 驱动的工作流增效。

只需告诉 MCP 服务你想做什么，例如：

• “切换 isVisited 用户偏好设置”
• “关闭引导指南”
• “列出所有用户偏好设置值”
• "创建一个值为当前 epoch 时间的时间戳偏好设置"

只需提问，即可体验更智能、更快速的 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 桌面应用的 MCP 工具包中启用 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 -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 Inspector 对此 MCP 服务进行可视化调试。

npx @modelcontextprotocol/inspector npm run start

许可证

请参阅 LICENSE

联系方式

如有疑问或需要支持，请通过 GitHub Issues 联系我们。

贡献

欢迎社区贡献！🎉

首次贡献者： 请先阅读我们的 CONTRIBUTING.md 指南，其中介绍了：

• PR 要求和标题格式
• 开发环境设置和工作流
• 代码质量标准
• 许可证信息

详细的开发说明请参阅 DEV.md。