# mathd
## 基本信息
- Slug: `mathd-govee_mcp_server`
- Source: modelscope
- Publisher: @mathd/govee_mcp_server
- Categories: home-automation-and-iot / command-line / app-automation
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@mathd/govee_mcp_server
## 简介
暂无描述。
## MCP Server 详情

# Govee MCP 服务器

[![smithery 徽章](https://smithery.ai/badge/@mathd/govee_mcp_server)](https://smithery.ai/server/@mathd/govee_mcp_server)

通过 Govee API 控制 Govee LED 设备的 MCP 服务器。

## 设置

### 环境变量

在根目录下创建一个 `.env` 文件，并包含以下变量：

bash
GOVEE_API_KEY=your_api_key_here
GOVEE_DEVICE_ID=your_device_id_here
GOVEE_SKU=your_device_sku_here


获取这些值的方法：
1. 从 Govee 开发者门户获取您的 API 密钥
2. 使用 Govee Home 应用程序找到您的设备 ID 和 SKU

## 安装

### 通过 Smithery 安装

要通过 [Smithery](https://smithery.ai/server/@mathd/govee_mcp_server) 自动为 Claude Desktop 安装 Govee MCP 服务器，请运行：

bash
npx -y @smithery/cli install @mathd/govee_mcp_server --client claude


### 手动安装

bash
# 使用 pip 安装
pip install .

# 开发环境（包括测试依赖项）
pip install -e ".[test]"


## 使用

### MCP 服务器

MCP 服务器提供了通过 Model Context Protocol 控制 Govee 设备的工具。它可以与 Cline 或其他 MCP 客户端一起使用。

可用工具：
- `turn_on_off`: 开启或关闭 LED
- `set_color`: 使用 RGB 值设置 LED 颜色
- `set_brightness`: 设置 LED 亮度级别

### 命令行界面

提供了一个命令行界面，可以直接控制 Govee 设备：

bash
# 开启/关闭设备
govee-cli power on
govee-cli power off

# 使用 RGB 值（0-255）设置颜色
govee-cli color 255 0 0  # 红色
govee-cli color 0 255 0  # 绿色
govee-cli color 0 0 255  # 蓝色

# 设置亮度（0-100）
govee-cli brightness 50


运行 `govee-cli --help` 查看完整的命令文档。

## 开发

### 运行测试

要运行测试套件：

bash
# 安装测试依赖项
pip install -e ".[test]"

# 运行所有测试
pytest tests/

# 运行特定测试文件
pytest tests/test_server.py  # 服务器测试（模拟 API 调用）
pytest tests/test_cli.py    # CLI 测试（真实 API 调用）

# 以详细输出运行测试
pytest tests/ -v


注意：CLI 测试会向您的 Govee 设备发出真实的 API 调用并实际控制它。请确保在运行这些测试之前，您的设备已通电并连接。

### 项目结构


.
├── src/govee_mcp_server/
│   ├── __init__.py
│   ├── server.py    # MCP 服务器实现
│   └── cli.py       # 命令行界面
├── tests/
│   ├── test_server.py  # 服务器测试（模拟 API）
│   └── test_cli.py     # CLI 测试（真实 API 调用）
└── pyproject.toml      # 项目配置


### 测试覆盖率

- 服务器测试覆盖：
  - 环境初始化
  - Govee API 客户端方法
  - 服务器工具和实用程序
  - 错误处理

- CLI 测试通过执行实际的 API 调用来控制您的 Govee 设备，进行真实世界的集成测试。