CheerLights MCP服务器使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 构建的服务器，它作为 Claude 等大型语言模型 (LLM) 的外部上下文信息源，桥接了 CheerLights 这个全球联网灯光项目。CheerLights 项目同步全球灯光的颜色，用户可以通过这个服务器让 LLM 了解当前的 CheerLights 灯光颜色以及历史变化。

主要功能点

获取当前 CheerLights 颜色：LLM 可以询问当前全球 CheerLights 灯光显示的颜色。
查看 CheerLights 颜色历史：LLM 可以查询最近的 CheerLights 颜色变化记录。
实时数据集成：服务器实时从 CheerLights API 获取数据，确保 LLM 获取的信息是最新的。

安装步骤

安装依赖库：打开终端或命令提示符，运行以下命令安装必要的 Python 库 'mcp' 和 'httpx'。
```
pip install mcp httpx
```
保存服务器代码：将仓库中的 'server.py' 文件保存到您的计算机上，例如保存到 '~/cheerlights-mcp/server.py' (macOS/Linux) 或 'C:\cheerlights-mcp\server.py' (Windows)。

服务器配置

为了让 MCP 客户端（例如 Claude for Desktop）连接到 CheerLights MCP 服务器，您需要配置客户端的配置文件。以下是配置信息，您需要根据您的 'server.py' 文件路径进行调整。

Claude for Desktop 配置 (JSON 格式)

请将以下 JSON 配置添加到 Claude for Desktop 的配置文件中：

Windows: '%APPDATA%\Claude\claude_desktop_config.json'
macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'

{
    "mcpServers": {
        "cheerlights": {
            "command": "python",
            "args": ["/path/to/server.py"]  // 将 "/path/to/server.py" 替换为 server.py 文件的实际路径，例如 "C:\\cheerlights-mcp\\server.py" (Windows) 或 "/Users/yourusername/cheerlights-mcp/server.py" (macOS/Linux)
        }
    }
}

配置说明:

'"mcpServers"': 定义 MCP 服务器配置的顶层键。
'"cheerlights"': 为该 MCP 服务器定义的名称，您可以自定义，Claude 中通过这个名称来识别服务器。
'"command"': 启动 MCP 服务器的命令，这里使用 'python' 命令来运行 Python 脚本。
'"args"': 传递给 'command' 的参数列表。
- '"/path/to/server.py"': 请务必替换为 'server.py' 文件在您电脑上的实际路径。 例如，如果您将 'server.py' 保存在 'C:\cheerlights-mcp' 目录下，则应填写 '"C:\cheerlights-mcp\server.py"' (注意 Windows 路径中的反斜杠需要转义)。

重要提示: 配置完成后，您可能需要重启 Claude for Desktop 以使配置生效。

基本使用方法

配置完成后，您就可以在 Claude 中使用以下自然语言指令与 CheerLights MCP 服务器交互了：

查询当前颜色:
- "What's the current CheerLights color?" (当前 CheerLights 是什么颜色？)
- "Tell me the current CheerLights color." (告诉我当前的 CheerLights 颜色。)
查询颜色历史:
- "Show me the last 10 CheerLights color changes." (显示最近 10 次 CheerLights 颜色变化。)
- "What were the CheerLights colors in the last 5 changes?" (最近 5 次 CheerLights 颜色分别是什么？)

Claude 会将这些问题发送到 CheerLights MCP 服务器，服务器会调用相应的工具获取 CheerLights 数据，并将结果返回给 Claude。

关键词