Android 项目文件 MCP 服务器配置

概述

此项目提供了一个 Claude MCP 服务器，支持安全访问 Android 项目的文件。它允许 AI 助手浏览和阅读 Android 项目的源代码，通过检查必要的 Gradle 配置文件来验证合法的 Android 项目。

关键功能：

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

此工具非常适合希望利用 Claude 来帮助理解、分析和处理 Android 代码库的开发者。

服务器设置

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

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

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

安装

# 如果没有安装，请先安装 UV
curl -LsSf https://astral.sh/uv/install.sh | sh

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

许可证

MIT 许可证 - 详细信息请参阅 LICENSE