Tokennuke MCP Server

Code indexing MCP: 15 tools, 10 languages, hybrid search, call graphs, O(1) retrieval.

Local serverstdioPython

What is the Tokennuke MCP server?

Connect Tokennuke to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Code indexing MCP: 15 tools, 10 languages, hybrid search, call graphs, O(1) retrieval. The tokennuke mcp server is what makes that connection.

What the server does

Intelligent code indexing MCP server. 15 tools, 10 languages, tree-sitter AST extraction, hybrid search (FTS5 + vector), call graphs, remote repo indexing, incremental indexing.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • index_folder — Index a local directory (incremental, SHA-256 based)
  • index_repo — Index a GitHub/GitLab repo (tarball download, no git needed)
  • list_repos — List all indexed repositories with stats
  • invalidate_cache — Force re-index a repository
  • file_tree — Get directory tree with file counts
  • file_outline — List symbols in a single file
  • repo_outline — List all symbols in repo (summary)
  • get_symbol — Get full source of one symbol (O(1) byte seek)
  • get_symbols — Batch get multiple symbols
  • search_symbols — Hybrid search (FTS5 + vector RRF)
  • search_text — Full-text search in file contents
  • get_callees — What does this function call?

Installation

Installation goes through your MCP client rather than a global install: point it at tokennuke on PyPI and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

Where it fits

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Tokennuke's toolset — index_folder, index_repo, list_repos and 11 more — is a fair guide to whether it matches your workflow. It is maintained by BigJai; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Tokennuke's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Tokennuke.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
index_folderIndex a local directory (incremental, SHA-256 based)
index_repoIndex a GitHub/GitLab repo (tarball download, no git needed)
list_reposList all indexed repositories with stats
invalidate_cacheForce re-index a repository
file_treeGet directory tree with file counts
file_outlineList symbols in a single file
repo_outlineList all symbols in repo (summary)
get_symbolGet full source of one symbol (O(1) byte seek)
get_symbolsBatch get multiple symbols
search_symbolsHybrid search (FTS5 + vector RRF)
search_textFull-text search in file contents
get_calleesWhat does this function call?
get_callersWho calls this function?
diff_symbolsWhat changed since last index? (PR review)

How to install the Tokennuke MCP server

{
  "mcpServers": {
    "tokennuke": {
      "command": "uvx",
      "args": ["tokennuke"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • Use Tokennuke to index folder.
  • Use Tokennuke to index repo.
  • Use Tokennuke to list repos.

Frequently asked questions

It connects Tokennuke to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (index_folder, index_repo, list_repos, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Tokennuke directly.