返回 MCP 目录
public公开dns本地运行

cheerlights-mcp

一个连接AI工具与CheerLights物联网灯光系统的MCP协议服务器

article

README

🚀 欢乐之光 MCP 服务器

欢乐之光 MCP 服务器是一个模型上下文协议(MCP)服务器,它为Claude或其他人工智能工具提供了与CheerLights API交互的能力。CheerLights是一个全球物联网项目,能在全球范围内同步连接灯具的颜色,本服务器可让你轻松获取相关颜色信息。

🚀 快速开始

欢乐之光 MCP 服务器允许Claude等人工智能工具与CheerLights API交互,实现获取颜色信息等功能。下面为你详细介绍使用步骤。

✨ 主要特性

  • 获取当前颜色:可获取当前的CheerLights颜色。
  • 查看历史记录:能查看最近的颜色更改历史。
  • 实时集成:实现与CheerLights API的实时集成。

📦 安装指南

首先,你需要安装必要的依赖项,在命令行中执行以下命令:

pip install mcp httpx

💻 使用示例

基础用法

将代码保存到文件(例如server.py),然后在命令行中运行它:

python server.py

与Claude桌面版连接

在Claude桌面版配置中添加以下内容:

  • 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"]
        }
    }
}

使用Claude

在重启Claude桌面版后,你可以向Claude提出以下问题:

  • “当前CheerLights颜色是什么?”
  • “显示最后10次CheerLights颜色更改”

📚 详细文档

API 参考

该服务器使用了CheerLights API端点: http://api.thingspeak.com/channels/1417/field/1/last.json

博客教程

你可以参考以下博客教程,了解如何为Claude Desktop和Windsurf创建自己的MCP服务器: 如何为Claude Desktop 和Windsurf 创建自己的MCP 服务器

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端