Govee MCP Server

🚀 Govee MCP 服務器

一個藉助 Govee API 來控制 Govee LED 設備的 MCP 服務器。此服務器為用戶提供了便捷的方式，通過簡單的操作即可實現對 Govee LED 設備的靈活控制。

🚀 快速開始

在使用 Govee MCP 服務器前，你需要進行一些必要的配置。首先，在根目錄下創建一個 .env 文件，該文件需包含以下環境變量：

GOVEE_API_KEY=你的_api_key_這裡
GOVEE_DEVICE_ID=你的設備_id_這裡
GOVEE_SKU=你的設備_spu_這裡

獲取這些值的方法如下：

1. 在 Govee 開發者控制檯獲取你的 API key。
2. 使用 Govee Home 應用來查找你的設備 ID 和 SKU。

📦 安裝指南

通過 Smithery 安裝

若要自動安裝 Govee MCP 服務器供 Claude 桌面版使用，可訪問 Smithery，並執行以下命令：

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

手動安裝

# 通過 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 亮度。

命令行界面

提供了一個 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 測試會進行實際的 API 調用，控制你的 Govee 設備。在運行這些測試之前，請確保設備已通電並連接。

項目結構

.
├── 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 設備。