MCP 服务器

MSC MCP Server

Enables control of Android devices through ADB, allowing users to list connected devices, capture screenshots using multiple methods (adb, droidcast, minicap, mumu), and retrieve device information.

README

MSC MCP Server

MCP server for MSC (Multi‑Screencap 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"
      ]
    }
  }
}