lvgl MCP

lvgl-mcp

要浏览的 MCP 服务器 LVGL （文档和示例）以版本化的方式，集成了Claude Code和Roo Coder等主机。

概述

此服务器将 MCP 工具暴露给 ：

• 寻找 LVGL 的官方范例 （search_examples / get_example)
• 浏览已索引的 HTML 文档 （search_docs / get_doc)
• 列出已知部件（ L）list_widgets)
• 调整目标版本（ R）set_default_version)

所有索引都是在本地 LVGL 树上进行的 （repo/HTML 文档（docs/（按版本排序）v9.2等等）。

缓存结构

由控制 LVGL_CACHE_DIR （默认值： ~/.cache/lvgl-mcp):

• repo// 在此版本中克隆 LVGL 仓库
• docs// 此版本的 LVGL 文档的 HTML
• index/docs_.sqlite FTS Doc 索引
• index/repo_.sqlite – 示例/演示的FTS指数

依赖关系

在 venv Python （3.10+） 中：

pip install "mcp[cli]" beautifulsoup4 lxml

索引（例如 v9.2）

export LVGL_CACHE_DIR=~/.cache/lvgl-mcp

# Repo LVGL clonado em: ~/.cache/lvgl-mcp/repo/v9.2
python index_repo.py --version v9.2 --repo-root "$LVGL_CACHE_DIR/repo/v9.2"

# Docs HTML em: ~/.cache/lvgl-mcp/docs/v9.2
python index_docs.py --version v9.2 --docs-root "$LVGL_CACHE_DIR/docs/v9.2"

正在运行 MCP 服务器

export LVGL_CACHE_DIR=~/.cache/lvgl-mcp
export LVGL_DEFAULT_VERSION=v9.2

python server.py

进程运行在 标准 并且必须由MCP主机（Claude，Roo等）调用。

在 Claude （WSL） 中注册示例

claude mcp add --transport stdio lvgl-docs   --scope user   --env LVGL_CACHE_DIR=/home/SEU_USUARIO/.cache/lvgl-mcp   --env LVGL_DEFAULT_VERSION=v9.2   -- /home/SEU_USUARIO/dev/lvgl-mcp/.venv/bin/python /home/SEU_USUARIO/dev/lvgl-mcp/server.py