winpc-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@winpc-mcpcheck the CPU usage on my PC"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
winpc-mcp
从 iPad(Minis)通过 MCP 远程控制 Windows 电脑。
在电脑上运行一个 MCP 服务器,iPad 上的 Minis 通过 HTTP 调用它的工具: 执行命令、管理文件、截屏、控制键盘鼠标、打开应用、管理进程、下载文件等 —— 就像在电脑本地跑了一个 agent。
┌────────── iPad ──────────┐ ┌────────── Windows 电脑 ──────────┐
│ Minis (MCP 客户端) │ HTTP │ winpc-mcp (MCP 服务器) │
│ minis-mcp-cli 调用工具 │◀──────▶│ :8765/mcp (Bearer Token) │
└──────────────────────────┘ └──────────────────────────────────┘
局域网直连 / Tailscale / 隧道✨ 功能
类别 | 工具 |
命令 |
|
文件 |
|
屏幕 |
|
输入 |
|
应用 |
|
系统 |
|
网络 |
|
Related MCP server: pc-control-mcp
🚀 快速开始
1. 电脑端(Windows)
:: 方式一:一键脚本(自动建虚拟环境、装依赖、启动)
start.bat
:: 方式二:手动
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
python server.py启动后终端会打印:
MCP 地址: http://192.168.x.x:8765/mcp
Token: xxxxx(未配置时自动生成,请保存)
Dashboard: http://192.168.x.x:8765/dashboard固定 Token:把
config.example.json复制为config.json,填入你的 token, 或设置环境变量WINPC_TOKEN。自动生成的 token 每次重启都会变。
2. iPad 端(Minis)
minis-mcp-cli add --name winpc \
--url http://<电脑IP>:8765/mcp \
--header "Authorization: Bearer <token>"
minis-mcp-cli tools winpc # 查看工具
minis-mcp-cli call winpc system_info # 测试调用之后在 Minis 对话里直接说“帮我看看电脑的 CPU 占用”即可。
📊 Dashboard(电脑端实时监控)
电脑浏览器打开 http://<电脑IP>:8765/dashboard(或本机 localhost:8765):
DIALOGUE:实时显示 iPad 端对话(Minis 通过
sync_chat工具同步,或POST /api/chat)TOOL CALLS:每次工具调用的完整记录——参数、结果、耗时、成功/失败状态
SCREEN + SYSTEM:最近截图画廊(点击放大)+ CPU/内存/磁盘实时状态
⌘K 命令面板:过滤工具调用、跳转面板、暂停/恢复实时流、清空日志、复制地址
可配置 dashboard_password 口令保护(开启后首次访问需输入口令)。
🔒 安全
所有
/mcp和/files请求必须带Authorization: Bearer <token>默认只监听局域网;不要把 8765 端口直接映射到公网
异地访问推荐 Tailscale(加密隧道),两端装 app 登录同一账号后, MCP 地址直接换成 Tailscale IP(
http://100.x.x.x:8765/mcp)即可config.json可配置:allowed_dirs:限定文件操作目录(空 = 不限制,完全操控)confirm_dangerous:true时删除文件 / 杀进程需显式confirm=true
⚙️ 配置
{
"host": "0.0.0.0", // 监听地址
"port": 8765, // 端口
"token": "", // MCP 认证 token(留空则自动生成)
"allowed_dirs": [], // 文件操作白名单目录(空=不限制)
"confirm_dangerous": false, // true=危险操作需确认
"dashboard_password": "" // Dashboard 访问口令(空=不设防)
}📝 开发
# 本地(非 Windows)也能启动核心功能测试:
# run_powershell/run_cmd/键盘鼠标/截图等 Windows 专属工具会返回明确错误
pip install -r requirements.txt
python server.py工具代码在 winpc/ 目录,新增工具 = 在 tools_*.py 里加一个带 @tool 装饰器和
类型注解 + docstring 的函数即可,启动时自动注册。
🛣️ 路线图
Dashboard:电脑浏览器实时查看对话、工具调用、截图
Dashboard 动效:状态过渡、计数反馈、清空退出(v1.1.1)
浏览器自动化(CDP 驱动 Chrome)
开机自启(任务计划程序)
📄 License
MIT
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceProvides comprehensive computer control capabilities including mouse and keyboard automation, screen capture, OCR text recognition, and window management through MCP protocol.1MIT
- Flicense-qualityDmaintenanceEnables remote PC control and system management through MCP, including hardware info, process and file operations, with security features like blocklists and audit logging.
- Alicense-qualityCmaintenanceEnables remote filesystem and CLI access to a Windows machine over LAN through MCP, with file read/write and command execution capabilities.MIT
- Alicense-qualityCmaintenanceEnables remote execution of commands, file operations, screenshots, and clipboard access on Windows machines through MCP tools.1MIT
Related MCP Connectors
Eyes and hands on real Windows PCs — observe, click, type via Glasswarp API.
Remote MCP for Android CLI agent build gate, structured receipts, audit logs, and reviewer-ready evi
Secure MCP access to Big Red Cloud accounting data, workflows, help and training.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/MrColder666/winpc-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server