项目简介

这是一个基于 Model Context Protocol (MCP) 的小型服务器，旨在通过提供一个简单的工具，让兼容MCP的AI客户端（如Claude Desktop）能够与macOS系统交互，控制深色/浅色模式的切换。

主要功能点

• 提供名为 'toggle_dark_mode' 的工具：AI客户端可以发现并调用此工具。
• 执行系统命令：调用工具后，服务器会运行macOS的脚本命令来切换系统的显示模式（深色或浅色）。

安装步骤

1. 克隆项目仓库。

2. 进入项目目录。

3. 使用 'uv' 或 'pip' 安装项目依赖。例如，如果使用 'uv'：

   git clone https://github.com/felixweinberger/mcp-toggle-dark-mode.git
   cd mcp-toggle-dark-mode
   uv sync # 或者 pip install -r requirements.txt
   

服务器配置

要让您的MCP客户端（如Claude Desktop）使用此服务器，需要将其配置添加到客户端的设置文件中。通常是一个 JSON 文件，您需要指定服务器的启动方式。

以下是一个配置示例的说明：

• 服务器名称 (server name): 您给这个服务器起的一个内部名称，例如 'dark-mode-toggle'。
• 命令 (command): 启动服务器的主程序或解释器，例如 'python'。
• 参数 (args): 启动命令所需的参数列表，例如服务器主脚本的路径 '["/path/to/mcp-toggle-dark-mode/main.py"]'。请将 '/path/to/mcp-toggle-dark-mode/main.py' 替换为您实际安装 'main.py' 文件的完整路径。

基本使用方法

配置并重启您的MCP客户端后，AI助手应该能够识别到 'toggle_dark_mode' 工具。您可以通过与AI对话来请求切换模式，例如说“切换macOS深色模式”或“把系统调回浅色模式”。AI客户端会调用这个MCP服务器上的工具来执行操作。