慢读清单 MCP Server

把 Jun 的「慢读清单」阅读存档（Hatch web artifact space）开放成只读的 MCP 工具， 让 AI agent 可以搜索、浏览、引用这些收藏的文章。这是"给 agent 用的服务"的第一个实验： agent 成为用户，来读人的精选。

工具（只读）

Related MCP server: PubMed MCP Server

快速开始

cd ~/workspace/mcp-slowread
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python test_client.py   # 端到端自检

stdio（Claude Code / Cursor 本地接入）

Claude Code (~/.claude.json 或项目 .mcp.json)：

{
  "mcpServers": {
    "slowread": {
      "command": "/home/hatch/workspace/mcp-slowread/.venv/bin/python",
      "args": ["/home/hatch/workspace/mcp-slowread/server.py"]
    }
  }
}

Cursor：Settings → MCP → Add new global MCP server，填同样的 command/args。

SSE（部署给远端 agent）

.venv/bin/python server.py --transport sse --port 8000

远端 agent 连 http://<host>:8000/sse。注意：这是只读公开元数据服务， 但仍建议只在可信网络暴露，或前面加一层反向代理做鉴权/限流。

数据刷新

data/articles.json 是静态快照（当前 44 篇，2026-09-06 抓取）。 MCP server 不直连线上 app——这是有意为之：快照简单、可审计、 不怕把线上库拖慢。刷新快照时重新从 artifact 抓取并覆盖该文件即可 （只读抓取，见 artifact.invoke_action 的 listarticles action， slug=space，args={"limit":200,"status":"all"}）。

日志

每次工具调用追加一行 JSON 到 logs/access.log： {"ts": ..., "tool": ..., "args": {...}}。只记元数据， 不记录文章全文。

隐私说明

• 只读：没有任何写入、删除、修改线上「慢读清单」的工具。

• 只暴露文章的公开元数据（标题、链接、来源、摘要、笔记、标签）—— 这些本来就是 Jun 收藏的公开网页，加上他自己的中文点评。

• 无密钥、无账号体系。data/articles.json 是明文快照， 分享/部署前请确认内容可公开。