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"
      ]
    }
  }
}

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

---

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

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

uv run python -m msc_mcp

或使用脚本入口：

uv run msc-mcp

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

---

项目结构

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

---

贡献与开发

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

uv run python -m unittest