TokenKnows MCP server
io.github.johnnywuj81/tokenknows·v0.3.0·4 starsDistill AI coding sessions into weekly reports, ADRs and a knowledge graph - self-hosted
4 stars28 downloads/wk
Reviews
Write oneNobody has reviewed TokenKnows yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
TokenKnows tools (6, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
distill_document触发 backend 5-stage pipeline 蒸馏 events → 文档.
get_asset读单个 asset 元数据 (不含 chapter content).
get_asset_chapters读 asset 的所有 chapter (含 markdown content + layout).
list_assets列项目下的蒸馏文档.
search_entity跨文档实体搜索 (KG entity_registry).
submit_session_eventswrite actionPersist conversation events into TokenKnows backend.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan9 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 13 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How TokenKnows compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 48,255 servers
- Tools
- 6
- the typical server has 7
- Tools that change things
- 17%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 4
- more than 82% of 28,688 servers
- Downloads a week
- 28
- more than 15% of 12,191 servers with a package
What its tools let an agent do: 5 read · 1 change
Install TokenKnows in Claude Code, Cursor or VS Code
claude mcp add tokenknows -- uvx tokenknows-mcp
What the publisher says
From the TokenKnows repository's README, as published. We do not edit it. Read it on GitHub
TokenKnows Distill AI coding sessions into living knowledge — weekly reports, ADRs, incident reviews, books, agent skills, and a knowledge graph. English | 简体中文
What is TokenKnows?
You spend hours pair-programming with Claude Code, Codex, and Cursor. The decisions, bug hunts, and design trade-offs from those sessions evaporate the moment the terminal closes. TokenKnows captures them automatically and distills them into structured, evidence-linked knowledge assets:
capture (6 collectors) → distill (5-stage LLM pipeline) → assets (7 document types) → review / redact / publish
- 📡 Captures everything — Claude Code, Codex, Cursor, VS Code, GitHub PRs/commits/issues, and local docs, all via local file watchers and API polling. No webhooks, no tunnels.
- 📝 Seven asset types — weekly reports, tech designs, ADRs, incident reviews, long-form books, reusable agent skills (SKILL.md), and an entity knowledge graph.
- 🔗 Evidence-linked — every paragraph traces back to the original PR / conversation / commit, ranked by cosine × trust × recency across ≥2 sources.
- 🔒 Local-first, zero egress by default — a three-layer LLM egress gate (instance ∧ project ∧ task) with full audit logging. Pair it with Ollama and run the whole pipeline with zero cloud keys.
Demo
▶ Full walkthrough: engineering_handoff/walkthrough.mp4 (5 min, Chinese narration + subtitles)
All 12 screens
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
TokenKnows: common questions
- Is TokenKnows MCP server safe?
- Mostly: it is graded B (83/100). Read the TokenKnows safety report
- How do I install TokenKnows?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does TokenKnows need an API key?
- Yes. The registry entry asks for
TOKENKNOWS_API_TOKEN. - Is TokenKnows maintained?
- The last commit was 52 days ago (2026-09-13). The latest release is v0.3.0.
- What can I use instead of TokenKnows?
- Servers from other publishers that do the same job: Codebase Memory MCP server, Deja Vu MCP server and Neo4j Memory MCP server. Compare all TokenKnows alternatives.
- How does TokenKnows compare with other MCP servers?
- safety score 83/100 (higher than 65% of 48,255 servers); tools 6 (the typical server has 7); tools that change things 17% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to TokenKnows
Same job from other publishers: the closest match first, then the best rated.
- Codebase MemoryCodebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.not reviewedWidely usedC
- Deja Vudeja-vu: local memory over the session histories of forty-three coding agents.not reviewedEstablishedA
- Neo4j MemoryMCP Neo4j Knowledge Graph Memory Servernot reviewedEstablishedA