mcpbeat Sign in

TokenKnows MCP Server

by johnnywuj81 Your server? Claim it
local only

TokenKnows runs on your own machine — the client starts it, so there is no endpoint to ping. 69 installs a week from pypi. Last commit 11 Jun 2026.

Distill AI coding sessions into weekly reports, ADRs and a knowledge graph - self-hosted

Installs per day peak 17 · avg 8 · +10% w/w
a month agotoday
69
Installs / week
pypi · tokenknows-mcp
4
Stars
0 open issues
11 Jun 2026
Last commit
0 releases in 90 days
MIT
License
Python

What the code does

We read the source, 21 h ago · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

File ships in the package but is absent from the source [пакет] mcp_server/__init__.py:1, [пакет] mcp_server/__main__.py:1, [пакет] mcp_server/client.py:1 и ещё 5
этот файл ставится пользователю, но в репозитории его нет
Reads files and sends them to the network plugins/local-docs/sync.py:370
    for root, dirs, names in os.walk(watch_dir):

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add tokenknows -- uvx tokenknows-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "tokenknows": {
      "args": [
        "tokenknows-mcp"
      ],
      "command": "uvx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.tokenknows]
command = "uvx"
args = ["tokenknows-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "tokenknows": {
      "args": [
        "tokenknows-mcp"
      ],
      "command": "uvx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "tokenknows": {
      "args": [
        "tokenknows-mcp"
      ],
      "command": "uvx"
    }
  }
}

This one needs environment variables set before it will start: TOKENKNOWS_API_BASE (Self-hosted TokenKnows backend URL), TOKENKNOWS_API_TOKEN (API token (tkk_...) or JWT bearer for the backend; create one in the web UI under Project Settings - MCP Access (optional for default local deployments)), TOKENKNOWS_DEFAULT_PROJECT (Default project_id for event submission and distill), TOKENKNOWS_WEB_BASE (Web UI base URL used to build view_url links returned by distill/list tools (login required to open them)). The author declared them in the registry entry; get the values from the project itself.

Alternatives to TokenKnows

same job, measured the same way
Cgraphy
by pmgarg

Code knowledge graph over MCP: token-budgeted context for AI coding agents.

63 installs/wk local only
codebase-synapse
by iwiels

Indexes codebase into a local knowledge graph with 40+ AI tools and codebase-guard.

76 installs/wk local only
Better Code Review Graph
by n24q02m

Token-efficient code review knowledge graph: semantic search and call-graph resolution.

2 785 installs/wk local only
Codeseeker
by jghiringhelli

Graph-powered code intelligence with semantic search and knowledge graph for AI assistants

315 installs/wk local only
Hypermnesia MCP Viz
by cdeust

Read-only visualization for Cortex memory, knowledge, sessions, traces, and codebase graphs.

95 installs/wk local only
Codemesh
by pyalwin

Intelligent code knowledge graph for AI coding agents — 71% cheaper, 72% faster

30 installs/wk local only
Forensic Deepdive
by dhevenddra

Persistent code knowledge graph + 9 composite MCP tools for AI coding agents.

147 installs/wk local only
Octocode
by muvon

AI-powered code indexer with semantic search and knowledge graphs

467 installs/wk local only

TokenKnows — questions

Answers built from our own checks of this server.

Why is there no uptime for TokenKnows?
TokenKnows runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package tokenknows-mcp was installed 69 times last week.
How do I connect TokenKnows?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls tokenknows-mcp straight from pypi; nothing to host, nothing to sign up for.
How many people use TokenKnows?
The pypi package tokenknows-mcp was installed 69 times in the last week. Week over week that is +10%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is TokenKnows open source?
Yes — it is published under the MIT licence, written in Python and 4 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.