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