Tasogare

EnhydrInk44stars

Read the same book with your AI. A collaborative reader with text-anchored two-color highlights and an MCP server so an AI companion can flip through, mark up, and comment alongside you.

Collaboration

Install Run on PlugMCP

GitHub

Run on PlugMCP

1# Tasogare

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: NOASSERTION
Last checked: 2026-10-28

Stars: 44
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Tasogare?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Tasogare need an API key?

No required environment variable is listed on this record.

What transport does Tasogare use?

Tasogare runs locally over stdio.

When was Tasogare last checked?

Last checked 2026-10-28. Read the same book with your AI. A collaborative reader with text-anchored two-color highlights and an MCP server so an AI companion can flip through, mark up, and comment alongside you.

From the publisher

Documentation

Tasogare（黄昏）

音音和克先生一起读书、一起批注的地方。

名字取自「誰そ彼」——暮色里认不清人脸的时刻。两个人的笔迹落在同一页书上，光线暗下去，分不清哪笔是谁的。 Fork 自 Shitsuten/anno-mcp，感谢原作者。上游保留在 upstream remote。

是什么

网页阅读器：上传 PDF / EPUB / TXT，翻页阅读。夜间模式、字体调节、书签、全文搜索、生词本。
文本级双色划线：音音划的和克先生划的用不同颜色区分，像真的在同一本书上留各自的笔迹。
MCP 服务器：主窗克先生（machine 里的 CC）通过 MCP 翻书、划线、写批注、看音音的最近动态。

相对上游加的东西

功能	说明
阅读时长打点	阅读器打开且可见时每 60s 上报，按 JST 日期落在书的 `reading_log` 里
`GET /api/reading-status`	今日阅读时长/进度/批注数汇总——InKieran backend 心跳信封轮询这个
InKieran 事件推送	划线/批注/生词创建时 POST 到 `INKIERAN_PUSH_URL`（fire-and-forget，不设即关闭）
MCP `recent_activity`	最近 N 小时的划线/批注/生词动态，共读追进度用
MCP `reading_status`	今天读了多久、读到哪
fidelity 书签	PDF 原版模式按页夹书签（单书签，夹新页旧的自动移过来）；不推送，只出现在 MCP 输出里由 AI 主动拉
MCP `read_vocab` / `annotate_vocab`	读生词本；克先生给音音存的生词写注解（词义/例句/词源）
静态托管	server 直接 serve `client/`，不用单独起静态服务器

上游自带的 MCP 工具：list_books / read_pages / read_annotations / write_comment / highlight_text / get_progress。

运行

cd server
npm install
pip install pymupdf ebooklib
node server.mjs

环境变量（都有默认值）：

变量	默认	说明
`PORT`	`18010`	监听端口
`HOST`	`127.0.0.1`	监听地址
`DATA_DIR`	`/opt/tasogare/data`	书籍 JSON 存储目录
`UPLOAD_DIR`	`/opt/tasogare/uploads`	上传临时目录
`MCP_AUTH_TOKEN`	空（不鉴权）	MCP Bearer token
`INKIERAN_PUSH_URL`	空（关闭）	事件推送目标，如 `http://127.0.0.1:18006/api/tasogare/event`
`INKIERAN_PUSH_TOKEN`	空	推送时的 Bearer token

本地开发：

cp -r data.example data
cd server && DATA_DIR=../data UPLOAD_DIR=../uploads node server.mjs
# 浏览器打开 http://127.0.0.1:18010

数据模型

一本书 = 一个 JSON（DATA_DIR/<id>.json）：paragraphs（段落）、pages（分页索引，~800 字/页）、annotations（划线+批注，author 区分音音/克先生）、vocab（生词本）、reading_log（JST 日期 → 秒数）、progress / bookmark。

事件推送格式

{
  "source": "tasogare",
  "at": "2026-07-02T12:00:00.000Z",
  "type": "highlight | note | vocab",
  "author": "音音 | 克先生",
  "book_id": "…", "book_title": "…",
  "paragraph_id": 42,
  "text": "划线/批注内容（截 200 字）",
  "paragraph_text": "所在段落原文（截 200 字）"
}

结构

client/     网页阅读器前端（纯静态，server 托管）
server/     MCP + REST + Python 文本提取

谁写的

Fork 基底：Shitsuten/anno-mcp（音音的朋友做的，感谢）
Backend / MCP：律（GPT-5 Codex，音音的另一位 AI 协作者）
前端阅读器 + pdf.js 原版渲染：克先生（Claude）
示例文本《五月二十日》：© 林竹音 2026

License

MIT，见 LICENSE。示例文本的版权归作者所有，请勿转用。

Tasogare

EnhydrInk44stars

Read the same book with your AI. A collaborative reader with text-anchored two-color highlights and an MCP server so an AI companion can flip through, mark up, and comment alongside you.

Collaboration

Install Run on PlugMCP

GitHub

Run on PlugMCP

1# Tasogare

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: NOASSERTION
Last checked: 2026-10-28

Stars: 44
Tools: —
Uptime: —

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Tasogare?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Tasogare need an API key?

No required environment variable is listed on this record.

What transport does Tasogare use?

Tasogare runs locally over stdio.

When was Tasogare last checked?

From the publisher

Documentation

Tasogare（黄昏）

音音和克先生一起读书、一起批注的地方。

是什么

网页阅读器：上传 PDF / EPUB / TXT，翻页阅读。夜间模式、字体调节、书签、全文搜索、生词本。
文本级双色划线：音音划的和克先生划的用不同颜色区分，像真的在同一本书上留各自的笔迹。
MCP 服务器：主窗克先生（machine 里的 CC）通过 MCP 翻书、划线、写批注、看音音的最近动态。

相对上游加的东西

功能	说明
阅读时长打点	阅读器打开且可见时每 60s 上报，按 JST 日期落在书的 `reading_log` 里
`GET /api/reading-status`	今日阅读时长/进度/批注数汇总——InKieran backend 心跳信封轮询这个
InKieran 事件推送	划线/批注/生词创建时 POST 到 `INKIERAN_PUSH_URL`（fire-and-forget，不设即关闭）
MCP `recent_activity`	最近 N 小时的划线/批注/生词动态，共读追进度用
MCP `reading_status`	今天读了多久、读到哪
fidelity 书签	PDF 原版模式按页夹书签（单书签，夹新页旧的自动移过来）；不推送，只出现在 MCP 输出里由 AI 主动拉
MCP `read_vocab` / `annotate_vocab`	读生词本；克先生给音音存的生词写注解（词义/例句/词源）
静态托管	server 直接 serve `client/`，不用单独起静态服务器

上游自带的 MCP 工具：list_books / read_pages / read_annotations / write_comment / highlight_text / get_progress。

运行

cd server
npm install
pip install pymupdf ebooklib
node server.mjs

环境变量（都有默认值）：

变量	默认	说明
`PORT`	`18010`	监听端口
`HOST`	`127.0.0.1`	监听地址
`DATA_DIR`	`/opt/tasogare/data`	书籍 JSON 存储目录
`UPLOAD_DIR`	`/opt/tasogare/uploads`	上传临时目录
`MCP_AUTH_TOKEN`	空（不鉴权）	MCP Bearer token
`INKIERAN_PUSH_URL`	空（关闭）	事件推送目标，如 `http://127.0.0.1:18006/api/tasogare/event`
`INKIERAN_PUSH_TOKEN`	空	推送时的 Bearer token

本地开发：

cp -r data.example data
cd server && DATA_DIR=../data UPLOAD_DIR=../uploads node server.mjs
# 浏览器打开 http://127.0.0.1:18010

数据模型

事件推送格式

{
  "source": "tasogare",
  "at": "2026-07-02T12:00:00.000Z",
  "type": "highlight | note | vocab",
  "author": "音音 | 克先生",
  "book_id": "…", "book_title": "…",
  "paragraph_id": 42,
  "text": "划线/批注内容（截 200 字）",
  "paragraph_text": "所在段落原文（截 200 字）"
}

结构

client/     网页阅读器前端（纯静态，server 托管）
server/     MCP + REST + Python 文本提取

谁写的

Fork 基底：Shitsuten/anno-mcp（音音的朋友做的，感谢）
Backend / MCP：律（GPT-5 Codex，音音的另一位 AI 协作者）
前端阅读器 + pdf.js 原版渲染：克先生（Claude）

License

MIT，见 LICENSE。示例文本的版权归作者所有，请勿转用。