项目简介

PC 功能 MCP 服务端(PC-MCP)是一个基于 Model Context Protocol (MCP) 构建的应用后端,旨在通过标准化的方式,让大型语言模型 (LLM) 客户端能够调用用户的个人电脑上的特定功能,如获取天气信息、执行系统操作、控制浏览器和进行屏幕截图等。

主要功能点

  • 天气信息: 查询美国地区的天气警报和详细天气预报。
  • 系统控制: 执行电脑的关机或重启操作,支持设置延迟和强制模式。
  • 浏览器搜索: 打开浏览器并根据关键词进行搜索,支持智能网址推断和指定浏览器。
  • 屏幕截图: 捕获当前屏幕的截图并保存到指定位置。

安装步骤

PC-MCP 是一个 Node.js 应用,安装和运行非常便捷。

  1. 确保已安装 Node.js: 需要 Node.js v18 或更高版本。请访问 Node.js官网 下载安装。
  2. 选择安装方式:
    • 推荐(无需安装): 直接使用 'npx' 命令运行。在终端输入:
      npx pc-mcp
    • 全局安装: 将 PC-MCP 安装到系统中,可以在任何位置直接运行。在终端输入:
      npm install -g pc-mcp
      安装完成后,即可在终端输入 'pc-mcp' 启动服务。

服务器配置 (供 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 服务端后,通过客户端的能力发现功能获取。

信息

分类

桌面与硬件