MSC MCP Server

MCP server for MSC (MultiScreencap Control)
提供通过 MCP 协议调用 Android 截图/设备信息等能力的后台服务

简单理解在支持 MCP 的客户端里例如 Claude 桌面版
可以把这个项目配置成一个本地 MCP Server然后直接调用
list_devices / capture_screenshot 等工具来操作你的 Android 设备

功能概览

• list_devices列出当前通过 ADB 连接的 Android 设备
• get_device_info获取指定设备的型号SDK 版本厂商等信息
• install_droidcast在指定设备上安装 DroidCast用于高质量投屏截图
• capture_screenshot从设备截取屏幕图像并以 PNG 形式通过 MCP 返回
  • 支持的截图方式adb默认droidcast``minicap``mumu

环境要求

• Python >= 3.10
• 已安装并在 PATH 中的 adb
• uv用于创建虚拟环境和运行命令
• 系统可以访问 GitHub 以安装 msc 依赖

安装与开发环境本地 clone 场景

在项目根目录执行会自动创建/使用 .venv 虚拟环境

uv sync

运行单元测试入口函数 + 工具函数

uv run python -m unittest tests.test_main tests.test_server

如需运行全部测试

uv run python -m unittest

通过 uvx 直接使用推荐免手动 clone 仓库

如果你只想在 MCP 客户端中使用本工具而不关心本地开发环境
可以使用 uvx 直接从 Git 仓库拉取并运行无需手动 git clone

假设本项目托管在https://github.com/<your-username>/msc-mcp
你可以这样启动 MCP server

uvx --from git+https://github.com/<your-username>/msc-mcp.git msc-mcp

说明

• uvx --from git+... 会在临时环境中安装运行依赖用完即走不污染全局环境
• msc-mcp 对应 pyproject.toml 里的脚本入口msc-mcp = "msc_mcp:main"
• 如果未来发布到了 PyPI也可以直接uvx msc-mcp

使用 uvx 的 MCP 客户端配置示例

以一个典型的 MCP 客户端伪代码为例

{
  "mcpServers": {
    "msc-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/<your-username>/msc-mcp.git",
        "msc-mcp"
      ]
    }
  }
}

这样配置后客户端在需要时会通过 uvx 自动拉取并运行本工具
用户无需提前 clone 仓库或手动创建虚拟环境

作为 MCP Server 启动本地开发调试

在本地 clone 了仓库并执行过 uv sync 后可以直接在项目根目录运行

uv run python -m msc_mcp

或使用脚本入口

uv run msc-mcp

这两种方式都会在标准输入/输出上启动 MCP server供支持 MCP 的客户端通过本地进程方式连接

项目结构

• src/msc_mcp/server.pyMCP 工具实现截屏设备信息等
• src/msc_mcp/__main__.py命令行/模块入口启动 MCP server
• tests/test_server.py针对工具函数的单元测试
• tests/test_main.py针对入口函数的单元测试

贡献与开发

• 新功能/修复请优先补充或更新 tests/ 下的对应单元测试
• 保持函数短小加上合理的类型标注Python 3.10+
• 在提交前确保所有测试通过

uv run python -m unittest