MCP.so
登录

CheerLights MCP Server

@cheerlights

关于 CheerLights MCP Server

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

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

cheerlights

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.

评论

其他 分类下的更多 MCP 服务器