Skip to main content
Glama
Edint386

glassreader

by Edint386
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

reader：千问 AI 眼镜看 TXT 小说（glassreader）

电脑端读 TXT、切章分页、把每页渲染成适合绿色光机的图片；眼镜上的 Waft-DSL 页面用镜腿滑动翻页，两侧栏和菜单是原生控件。翻页不经过大模型，页图请求本身就是阅读进度。打开书、换书、跳章、查进度走语音 → 大模型 → MCP 工具。

调研结论、方案比较、真机待验证清单见 docs/research.md。

路径

内容

glassreader/book.py

TXT 解码（UTF-8 / GB18030 / BOM）、切章、“第 N 章”查找

glassreader/pager.py

按章分页（禁则 / 悬挂标点 / 两端对齐）、页图渲染（478×290，4 级灰度 PNG）

glassreader/library.py

书库扫描、阅读位置（字符偏移 + 字号）、按计数差值翻页、跳转、进度文件

glassreader/mcp_tools.py

MCP 工具 list_books / open_book / jump / reading_status

glassreader/server.py

HTTP：页图 /r/<key>/<书>/<会话>/<计数>.png、MCP /mcp（Bearer，无状态）

glassreader/cli.py

glassreader serve / books / open

pages/reader/

眼镜阅读页 template.xml + Mock 数据 data.json（平台 Pages/reader 的本地源）

skill/

SKILL.md、ui_schema.json（平台技能的本地源）

deploy/

上线文件（2026-10-30 已执行）：OpenResty /reader/ 分流、第二条隧道、局域网转发器按路径分流，见 deploy/README.md

tests/

测试（不需要网络、服务器和真机）

samples/

原创示例小说（仅用于排版测试）

配置

复制 .env.example 为 .env 填好，set -a; . ./.env; set +a 后运行。优先级：命令行 > 环境变量 > 默认值。

变量

说明

READER_TOKEN

平台 MCP 插件的 Bearer Token。不填每次启动随机生成（平台插件会失效）

READER_KEY

页图地址里的随机段：眼镜发不了请求头，页图只能靠路径鉴权

READER_PUBLIC_URL

眼镜和平台访问的公网根地址，可带路径前缀（反代剥掉前缀后转发），如 https://cast.example.com/reader。不填只能本机联调

READER_BOOKS_DIR

TXT 书库目录，递归收集 *.txt（默认 ~/Books）

READER_STATE_FILE

进度文件（默认 ~/Library/Application Support/glassreader/progress.json）

READER_HOST / READER_PORT

监听地址（默认 127.0.0.1:8780）

READER_SWAP_SWIPE

1 = 前滑 / 后滑方向对调（真机方向与预期相反时用，不用改页面）

READER_ALLOWED_HOSTS

MCP 额外放行的 Host 头，逗号分隔

Related MCP server: Co Reading Kit

运行

下文的命令都假定仓库克隆在名为 reader 的目录里（和 glasscast 并排放）：

git clone https://github.com/Edint386/QwenGlass-Reader.git reader

电脑端要 macOS（排版用系统自带的冬青黑体 Hiragino Sans GB、宋体 Songti SC，见 glassreader/pager.py）、Python 3.12 和 uv。

cd reader && uv sync
cd reader && uv run pytest -q
cd reader && uv run glassreader serve --books samples --state .state/progress.json

不设 READER_PUBLIC_URL 时，启动信息里会打印一份能直接贴进模拟器的 dataSource。其他子命令：glassreader books（书库和进度）、glassreader open [书名]（打印一份新的 dataSource，key 要和 serve 一致）。

在本地模拟器里看

模拟器在 glasscast 项目里：把 glasscast 仓库克隆到本仓库旁边、目录名 glasscast，先运行它的 tools/simulator/fetch_assets.sh 下载内核。

cd glasscast && uv run python tools/simulator/serve.py --port 8772 --pages ../reader/pages

  1. 打开 http://127.0.0.1:8772/?preset=page:reader，等状态变成"就绪"。

  2. 把右侧 data 换成 serve 启动时打印的 dataSource（或 MCP open_book 返回的 u、t），点渲染。每次都要新会话号：内核按完整地址缓存页图，服务端按会话记计数基线。

  3. 触控键：后滑 next 下一页、前滑 prev 上一页、单击 confirm 开菜单。服务端日志会打印每次请求的计数差值和页码。

上平台（2026-10-30 已做，真机可用）

  1. 公网入口：cast.example.com 按路径 /reader/ 转给本服务。执行清单在 deploy/README.md（改新加坡 OpenResty、第二条隧道、局域网转发器分流）。

  2. 平台新建 MCP 插件（草稿）：基础 URL = READER_PUBLIC_URL，endpoint /mcp，认证 Bearer Token = READER_TOKEN（只填 token 本体），传输协议「无状态协议」。保存后应拉到 4 个工具。

  3. 新建技能「眼镜看小说」：贴 skill/SKILL.md，把里面的 READER 换成平台给这个插件的编码（形如 AbC123，工具卡片存成 ^^编码.工具名^^）；ui_schema.json 保持 []；新建页面 Pages/reader，贴 pages/reader/template.xml 和 data.json。

  4. 编辑器沙箱里说"看小说"，确认先调 open_book 再调 UI 页面渲染；然后真机测试 research §7 的 P1～P7。发布由你来点，范围选「个人私有」。

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Readbook MCP Server

    mkafw
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to help users manage their reading experience by searching books, tracking reading progress, managing bookmarks, and generating personalized recommendations and summaries.
    -

  • Co Reading Kit

    Youxuuuuu
    A
    license
    Not graded
    quality
    D
    maintenance
    A low-token human-AI co-reading MCP tool that imports local EPUB/TXT/Markdown books into chunks, enabling AI to read only relevant fragments and write co-reading results to long-term reading notes and progress files.
    77
    MIT

  • ss-reading-nest

    ice-star-blue
    A
    license
    Not graded
    quality
    B
    maintenance
    An MCP server that enables a private mobile-first reading experience in ChatGPT, managing multi-book shelves, reading progress, highlights, thoughts, and bookmarks, with secure cloud storage and AI co-reading of the current page.
    34
    MIT

  • Novel Workspace MCP

    LiZh132707
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI-driven long-form novel creation and management, including chapter generation, character and timeline tracking, semantic memory retrieval, version savepoints, and deep consistency checking across multiple projects through MCP tools, with support for local LM Studio or any OpenAI-compatible API.
    15
    MIT