LVGL文档和示例服务器

一个提供版本化LVGL文档和示例搜索服务的MCP服务器,支持与Claude Code和Roo Coder等主机集成。

  • by luiscarone
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 luiscarone/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/<versão>/ 在此版本中克隆 LVGL 仓库
  • docs/<versão>/ 此版本的 LVGL 文档的 HTML
  • index/docs_<versão>.sqlite FTS Doc 索引
  • index/repo_<versão>.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