MCP.so
Sign In

CheerLights MCP Server

@cheerlights

Basic information

Category

Other

License

MIT

Transports

stdio

Author

cheerlights

About CheerLights MCP Server

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

CheerLights MCP Server config

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

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

CheerLights MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

What transport methods does CheerLights MCP Server support?

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

3

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`.

4

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.

5

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.

Comments

More Other MCP servers