🚀 安卓项目文件 MCP 服务器配置

本项目提供了一个 Claude MCP 服务器，用于访问安卓项目文件。它能让 AI 助手通过检查必要的 Gradle 配置文件，浏览和读取安卓项目源代码，以此验证项目的合法性，为开发者提供了便利。

🚀 快速开始

将以下配置添加到您的 Claude 客户端 MCP 设置中：

{
  "mcpServers": {
    "Android 源代码": {
      "command": "/path/to/uv", 
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "./filesystem_android/main.py"
      ]
    }
  }
}

⚠️ 重要提示

请将 /path/to/uv 替换为您实际的 UV 安装路径。

✨ 主要特性

• 项目验证：通过检查 Gradle 文件确保目录是有效的安卓项目。
• 文件浏览：列出所有 Kotlin、KTS、TOML 文件及 AndroidManifest.xml，按目录分组显示。
• 文件读取：提供安全访问单个或多个文件的功能，并进行适当的过滤。
• 安全性：阻止对敏感目录（如 .gradle、.git 和 build 文件夹）的访问。

此工具非常适合希望利用 Claude 分析和处理安卓代码库的开发者。

📦 安装指南

# 安装缺失的 UV（如果有的话）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 初始化项目
uv venv
uv pip install -r uv.lock

📄 许可证

本项目采用 MIT 许可证，详细信息请参见 LICENSE。