🚀 Android 项目文件 MCP 服务器配置
本项目提供了一个 Claude MCP 服务器，可支持安全访问 Android 项目的文件。借助该服务器，AI 助手能够浏览和阅读 Android 项目的源代码，同时会通过检查必要的 Gradle 配置文件来验证项目是否为合法的 Android 项目，为开发者带来便利。
🚀 快速开始
将以下配置添加到您的 Claude 客户端的 MCP 设置中：
{
"mcpServers": {
"Android 源代码": {
"command": "/path/to/uv",
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"./filesystem_android/main.py"
]
}
}
}
⚠️ 重要提示
请将
/path/to/uv替换为您实际的 UV 安装路径。
✨ 主要特性
- 项目验证：通过检查 Gradle 文件确保目录是有效的 Android 项目。
- 文件浏览：列出所有 Kotlin、KTS、TOML 文件以及 AndroidManifest.xml 并按目录分组。
- 文件阅读：提供安全访问以读取单个或多个文件，带有适当的过滤机制。
- 安全性：阻止对敏感目录（如 .gradle、.git 和 build 文件夹）的访问。
此工具非常适合希望利用 Claude 来帮助理解、分析和处理 Android 代码库的开发者。
📦 安装指南
# 如果没有安装，请先安装 UV
curl -LsSf https://astral.sh/uv/install.sh | sh
# 初始化项目
uv venv
uv pip install -r uv.lock
📄 许可证
本项目采用 MIT 许可证，详细信息请参阅 LICENSE。