CheerLights MCP Server

Name: CheerLights MCP Server
Author: cheerlights

@cheerlights

Repository Homepage

About CheerLights MCP Server

MCP server that allows AI tools to interact with the CheerLights API.

#ai #mcp #cheerlights #claude-ai #mcp-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "cheerlights-mcp": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is CheerLights MCP Server?

CheerLights MCP Server is a Model Context Protocol (MCP) server that provides comprehensive access to the CheerLights API. CheerLights is a global IoT project that synchronizes colors across thousands of connected lights worldwide, creating a real-time shared experience. This server enables AI assistants to query and analyze CheerLights data.

How to use CheerLights MCP Server?

Install via uv sync or pip install -e . after cloning the repository. Run the server with uv run cheerlights-mcp or python -m cheerlights_mcp.server. Integrate with Claude Desktop by adding the server block to your claude_desktop_config.json. Supports stdio (default), sse, and streamable-http transports.

Key features of CheerLights MCP Server

Tools to get current color, history, statistics, and search colors
Resources for current color, formatted history, and supported colors list
Prompts for trend analysis and color reports
Structured output with Pydantic models and error handling
Configurable history count (1–100) and statistics sample size

Use cases of CheerLights MCP Server

Ask an AI assistant for the current CheerLights color and when it changed
Retrieve and analyze the last 20 color changes
Get color usage statistics over a configurable sample size
Search historical data for occurrences of a specific color
Look up hex codes and RGB values for any CheerLights color

FAQ from CheerLights MCP Server

What is CheerLights?

CheerLights is a global Internet of Things project that synchronizes colored lights around the world. Created by Hans Scharler in 2011, it connects thousands of lights that change color in near real-time when someone updates the color on the CheerLights Discord server.

What transport methods does CheerLights MCP Server support?

It supports stdio, sse, and streamable-http transports. The default is stdio (standard I/O).

How do I install CheerLights MCP Server?

Clone the repository and run either uv sync (recommended) or pip install -e .. The server can then be started with uv run cheerlights-mcp or python -m cheerlights_mcp.server.

What dependencies or runtime does it require?

Python 3.10+ is required. The project uses the modern MCP Python SDK, Pydantic models, and an async ThingSpeak API client.

Where does the CheerLights data come from?

The server retrieves color data from the CheerLights API via the ThingSpeak platform. It does not store or cache data locally beyond the current session.