Back to MCP directory
publicPublicdnsLocal runtime

Android Source Code Browser

一个提供安全访问Android项目文件的Claude MCP服务器

article

README

🚀 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

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client