MCP.so
ログイン

TokenKnows — distill AI coding sessions into weekly reports, ADRs and a knowledge graph

@johnnywuj81

リポジトリ

TokenKnows — distill AI coding sessions into weekly reports, ADRs and a knowledge graph について

Distill AI coding sessions (Claude Code / Codex / Cursor) into weekly reports, ADRs, incident reviews and a knowledge graph — local-first, evidence-linked.

基本情報

カテゴリ

メモリとナレッジ

ライセンス

MIT

ランタイム

python

公開者

johnnywuj81

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "tokenknows": {
      "command": "python3",
      "args": [
        "-m",
        "venv",
        ".venv",
        "&&",
        ".venv/bin/pip",
        "install",
        "-e",
        ".[dev]"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is TokenKnows?

TokenKnows automatically captures AI coding sessions (from tools like Claude Code, Codex, and Cursor) and distills them into structured knowledge assets such as weekly reports, ADRs, and a knowledge graph. It is for developers who want to preserve decisions and insights from AI pair-programming sessions.

How to use TokenKnows?

Install the TokenKnows backend (FastAPI) and web UI, then add the MCP plugin for your AI tool (Claude Code, Codex, Cursor, or VS Code). The plugin provides MCP tools like submit_session_events and distill_document, plus slash commands like /tokenknows:weekly. Run the backend with uvicorn app.main:app and frontend with npm run dev.

Key features of TokenKnows

  • Captures AI coding sessions from Claude Code, Codex, Cursor, and more.
  • Distills into seven asset types including weekly reports, ADRs, and incident reviews.
  • Every paragraph traces back to original PR, conversation, or commit.
  • Local-first with three-layer LLM egress gate for privacy.
  • Can run fully offline with Ollama and zero cloud keys.
  • All collectors run locally without webhooks or tunnels.

Use cases of TokenKnows

  • Automatically generate weekly reports from AI coding sessions.
  • Create Architecture Decision Records (ADRs) from design discussions.
  • Produce incident reviews with evidence from PRs and commits.
  • Build a knowledge graph of entities from multiple sessions.
  • Reusable agent skills (SKILL.md) for future automation.

FAQ from TokenKnows

Which AI tools does TokenKnows support?

It captures sessions from Claude Code, Codex, Cursor, VS Code, GitHub (PRs/commits/issues), and local documents.

Does TokenKnows require cloud LLM keys?

No. It can run fully locally with Ollama; optional cloud providers (Anthropic, OpenAI, MiniMax) require all three egress switches to be on.

How are citations ranked in documents?

Citations are ranked by cosine × trust × recency, requiring at least two distinct sources. Each paragraph links back to the original evidence.

Is TokenKnows local-first?

Yes. Zero egress by default; a three-layer LLM egress gate (instance, project, task) controls any cloud calls, with full audit logging.

What platforms are supported?

macOS provides a full experience with auto-starting collectors. Linux runs backend, frontend, and collectors manually. Windows is untested; WSL2 is recommended.

コメント

「メモリとナレッジ」の他のコンテンツ

Basic Memory

basicmachines-co

AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN

3.4K

Anytype MCP Server

anyproto

An MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.

467

Notion MCP Server

suekou

A Model Context Protocol server for connecting Notion to MCP-compatible clients

910

Context Portal MCP (ConPort)

GreatScottyMac

Context Portal (ConPort): A memory bank MCP server building a project-specific knowledge graph to supercharge AI assistants. Enables powerful Retrieval Augmented Generation (RAG) for context-aware development in your IDE.

763

Mcp Knowledge Graph

shaneholloman

MCP server enabling persistent memory for Claude through a local knowledge graph - fork focused on local development

871