Cheerlights MCP

🚀 CheerLights MCP Server

This is a Model Context Protocol (MCP) server that allows Claude or other AI tools to interact with the CheerLights API. CheerLights is a global IoT project that synchronizes the colors of connected lights worldwide.

🚀 Quick Start

✨ Features

• Retrieve the current CheerLights color.
• View the recent color change history.
• Integrate with the CheerLights API in real - time.

📦 Installation

First, install the necessary dependencies:

pip install mcp httpx

🚀 Running the Server

Save the code to a file (e.g., server.py) and run it:

python server.py

💻 Connecting with Claude Desktop

Add the following content to the Claude Desktop configuration:

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

{
    "mcpServers": {
        "cheerlights": {
            "command": "python",
            "args": ["path/to/server.py"]
        }
    }
}

💻 Using Claude

After restarting Claude Desktop, you can ask the following questions:

• "What is the current CheerLights color?"
• "Show the last 10 CheerLights color changes."

📚 Documentation

API Reference

The server uses the CheerLights API endpoint: http://api.thingspeak.com/channels/1417/field/1/last.json

Blog Tutorial

How to Create Your Own MCP Server for Claude Desktop and Windsurf