Ulanzi MCP

乌兰齐MCP服务器

  

  ](https://github.com/Jelloeater/ulanzi-mcp/blob/main/LICENSE)

用于Ulanzi TC001智能像素时钟（AWTRIX3固件）的MCP服务器和CLI。

特性

• MCP 服务器：通过AI助手（Claude Desktop、Cursor、Windsurf）控制您的Ulanzi时钟
• CLI工具：用于脚本编写和自动化的命令行界面
• 多时钟支持：从单个实例控制多个时钟
• API全面覆盖：访问所有AWTRIX3 HTTP API端点

快速开始

1.安装

cd ulanzi-mcp
uv sync

2.配置

复制 .env.example 到 .env 并设置时钟IP：

ULANZI_HOSTS=http://192.168.1.100

对于多个时钟：

ULANZI_HOSTS=http://192.168.1.100,http://192.168.1.101

3.使用CLI

# Check configuration
ulanzi info

# Turn on display
ulanzi power on

# Show notification
ulanzi notify "Meeting in 5 minutes!"

# Set brightness
ulanzi brightness 200

4.与MCP（克劳德桌面）一起使用

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "ulanzi-mcp": {
      "command": "uv",
      "args": ["--directory", "/path/to/ulanzi-mcp", "run", "python", "-m", "ulanzi_mcp.server"]
    }
  }
}

环境变量

可用工具/命令

看 docs/clock_spec.md 以获取完整的文档。

发展

# Run MCP server in development mode
uv run mcp dev src/ulanzi_mcp/server.py

# Run CLI
ulanzi --help

# Run tests
uv run pytest

许可证

麻省理工学院