AI导哈

智能像素时钟控制服务

Ulanzi MCP Server是一个用于控制Ulanzi TC001智能像素时钟（AWTRIX3固件）的服务和命令行工具，支持通过AI助手和脚本自动化操作。

  • by Jelloeater
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Jelloeater/ulanzi-mcp

使用说明

乌兰齐MCP服务器

用于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"]
    }
  }
}

环境变量

变量 描述 默认值
ULANZI_HOSTS 时钟地址，逗号分隔 http://192.168.1.100
ULANZI_USERNAME HTTP身份验证用户名 （无）
ULANZI_PASSWORD HTTP身份验证密码 （无）
ULANZI_API_TIMEOUT 请求超时（秒） 10
ULANZI_MQTT_PREFIX MQTT主题前缀 awtrix

可用工具/命令

看 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

许可证

麻省理工学院

相关 MCP