关键词

系统音量控制macOS自动化音频管理辅助功能工具服务器

使用说明

项目简介

本项目是一个基于Model Context Protocol (MCP) 的简单服务器实现，旨在为LLM客户端提供控制macOS系统音量的能力。通过注册 'mute_computer' 和 'unmute_computer' 两个工具，客户端可以远程静音或取消静音运行该服务器的Mac电脑。

主要功能点

  • 静音控制: 提供 'mute_computer' 工具，允许LLM客户端静音Mac电脑的系统音量。
  • 取消静音控制: 提供 'unmute_computer' 工具，允许LLM客户端取消静音Mac电脑的系统音量。
  • 标准MCP协议: 基于 '@modelcontextprotocol/sdk' 开发，遵循MCP协议规范，易于与兼容的MCP客户端集成。
  • Stdio传输: 使用标准输入/输出 (stdio) 作为服务器传输协议，简化部署和运行。

安装步骤

  1. 安装Node.js和npm: 确保您的系统已安装Node.js和npm。您可以从 nodejs.org 下载并安装。
  2. 克隆仓库: 将该GitHub仓库克隆到本地： 
    git clone https://github.com/samsel/onesies
cd onesies/mcp_mac_volume_controller
  3. 安装依赖: 在 'mcp_mac_volume_controller' 目录下，运行以下命令安装项目依赖： 
    npm install

服务器配置

MCP客户端需要以下配置信息才能连接到此服务器。请将以下JSON配置添加到您的MCP客户端配置中：

{
  "server_name": "mac-volume-controller",
  "command": "node",
  "args": ["index.js"]
  // command: 启动服务器的命令，这里使用 node.js 运行 index.js 文件。
  // args: 命令参数，这里指定运行 index.js 文件作为服务器入口。
  // server_name: MCP服务器的名称，用于在客户端识别和管理连接。
}

基本使用方法

  1. 启动服务器: 在 'mcp_mac_volume_controller' 目录下，运行以下命令启动MCP服务器：

    node index.js

    您应该在控制台上看到 'MCP Volume Controller Server running on stdio' 的信息，表示服务器已成功启动并正在监听来自stdio的请求。

  2. 配置MCP客户端: 根据您的MCP客户端的使用说明，配置服务器连接信息，将上述JSON配置填入客户端的服务器配置中。

  3. 使用工具: 在LLM客户端中，您可以调用 'mute_computer' 工具来静音Mac电脑，或调用 'unmute_computer' 工具来取消静音。服务器会将操作结果以文本形式返回给客户端。

例如，在与LLM对话时，您可以指示LLM调用 'mute_computer' 工具来关闭电脑声音，或调用 'unmute_computer' 工具来恢复声音。

信息

分类

桌面与硬件

访问项目