Mathd Govee MCP Server

🚀 Govee MCP 服務器

一個用於通過 Govee API 控制 Govee LED 設備的 MCP 服務器，藉助此服務器，你可以輕鬆實現對 Govee LED 設備的各項控制操作。

🚀 快速開始

在使用 Govee MCP 服務器之前，你需要完成環境配置，然後進行安裝操作。

✨ 主要特性

• MCP 服務器工具豐富：提供瞭如 turn_on_off、set_color、set_brightness 等工具，可通過 Model Context Protocol 控制 Govee 設備。
• 命令行界面便捷：提供 CLI 工具，能夠直接控制 Govee 設備，操作簡單。

📦 安裝指南

通過 Smithery 安裝

使用 Smithery 自動安裝 Govee MCP 服務器：

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

手動安裝

# 使用 pip 安裝
pip install .

# 開發模式（包含測試依賴）
pip install -e ".[test]"

環境配置

在項目根目錄下創建一個 .env 文件，添加以下變量：

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。

💻 使用示例

MCP 服務器

MCP 服務器提供了一些工具，用於通過 Model Context Protocol 控制 Govee 設備。 可用工具：

• turn_on_off：開啟或關閉 LED
• set_color：使用 RGB 值設置 LED 顏色
• set_brightness：設置 LED 亮度

命令行界面 (CLI)

提供一個 CLI 工具，可以直接控制 Govee 設備：

# 開啟或關閉設備
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 查看完整的命令文檔。

📚 詳細文檔

開發信息

運行測試

要運行測試套件：

# 安裝測試依賴
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      # 項目配置文件

測試覆蓋率

• 服務器測試：驗證 MCP 服務器的功能和性能。
• CLI 測試：測試命令行工具的實際操作和輸出。 通過這些測試，可以確保 Govee MCP 服務器在各種場景下的穩定性和可靠性。