项目简介
PC 功能 MCP 服务端(PC-MCP)是一个基于 Model Context Protocol (MCP) 构建的应用后端,旨在通过标准化的方式,让大型语言模型 (LLM) 客户端能够调用用户的个人电脑上的特定功能,如获取天气信息、执行系统操作、控制浏览器和进行屏幕截图等。
主要功能点
- 天气信息: 查询美国地区的天气警报和详细天气预报。
- 系统控制: 执行电脑的关机或重启操作,支持设置延迟和强制模式。
- 浏览器搜索: 打开浏览器并根据关键词进行搜索,支持智能网址推断和指定浏览器。
- 屏幕截图: 捕获当前屏幕的截图并保存到指定位置。
安装步骤
PC-MCP 是一个 Node.js 应用,安装和运行非常便捷。
- 确保已安装 Node.js: 需要 Node.js v18 或更高版本。请访问 Node.js官网 下载安装。
- 选择安装方式:
- 推荐(无需安装): 直接使用 'npx' 命令运行。在终端输入:
npx pc-mcp - 全局安装: 将 PC-MCP 安装到系统中,可以在任何位置直接运行。在终端输入:
安装完成后,即可在终端输入 'pc-mcp' 启动服务。npm install -g pc-mcp
- 推荐(无需安装): 直接使用 'npx' 命令运行。在终端输入:
服务器配置 (供 MCP 客户端使用)
MCP 客户端需要知道如何启动这个 MCP 服务器进程。通常需要在客户端配置中指定服务器的启动命令和参数。PC-MCP 使用 Stdio 传输协议进行通信。
以下是一个示例配置信息,供 MCP 客户端参考:
{ // MCP服务器名称,用于客户端识别 "serverName": "mcp-server-for-pc", // 启动服务器进程的命令 "command": "npx", // 或者 "pc-mcp" 如果已全局安装 // 启动命令所需的参数 "args": ["pc-mcp"] // 如果command是"pc-mcp",这里为空数组 [] // 其他可能的配置,如传输协议 (通常 Stdio 是默认或自动检测) // "transport": "stdio" }
- serverName: 服务端的唯一标识名称。
- command: 启动服务端的终端命令。推荐使用 'npx' 以避免全局安装。
- args: 'command' 后跟随的参数列表。对于 'npx pc-mcp',参数是 '["pc-mcp"]';如果全局安装后直接用 'pc-mcp' 命令启动,参数列表则为空 '[]'。
请根据你启动 PC-MCP 服务端的方式(使用 'npx' 或全局安装后直接运行)来配置 MCP 客户端。
基本使用方法 (供 MCP 客户端使用)
PC 功能 MCP 服务端启动后,会通过 Stdio 协议与连接它的 MCP 客户端通信。MCP 客户端可以通过调用服务端暴露的工具来使用其功能。
客户端通常会通过图形界面或编程接口,以工具调用的方式使用这些功能。你需要提供工具名称和对应的参数。
例如,客户端调用工具的逻辑:
- 调用 'get_alerts' 工具,提供 'state' 参数(如 '"CA"'),获取加州天气警报。
- 调用 'get_forecast' 工具,提供 'latitude' 和 'longitude' 参数(如 '34.05' 和 '-118.24'),获取指定坐标的天气预报。
- 调用 'shutdown_system' 工具,提供 'restart' (bool), 'delay' (number), 'force' (bool) 参数,执行关机或重启。
- 调用 'open_browser_search' 工具,提供 'keywords' (string) 参数,可以在浏览器中搜索。可选提供 'url' (string), 'browser' (enum), 'autoFindUrl' (bool) 参数。
- 调用 'capture_screenshot' 工具,可选提供 'savePath' (string) 参数,截取屏幕。
服务器会将工具执行结果(通常是文本形式)通过 MCP 协议返回给客户端。
详细的工具参数和描述可以在 MCP 客户端连接到 PC-MCP 服务端后,通过客户端的能力发现功能获取。
信息
分类
桌面与硬件