TokenScope: Token-Aware Directory Explorer

Created By

cdgaetea year ago

A tool to analyze directory structures while being mindful of token limitations for LLMs. Customize ignore files like gitignore patterns, such as .venv or node_modules

# mcp

# directory

Overview Content Tools Comments

Overview

TokenScope helps LLMs like Claude efficiently explore and understand codebases by providing token-optimized directory structure analysis and content extraction. Key features include:

Token-aware directory scanning with configurable depth and intelligent summaries
File content analysis with smart token limitations and special handling for formats like JSON
Token usage statistics to estimate processing requirements
Comprehensive reporting with directory structure, token statistics, and important file samples
Security features restricting operations to a specified base directory

TokenScope is built with FastMCP and uses tiktoken for accurate token counting. It requires Python 3.10+ and can be installed via PyPI or directly from GitHub for development.

Try in Playground

Server Config

{
  "mcpServers": {
    "TokenScope": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "tokenscope",
        "tokenscope",
        "--base-path",
        "/your/secure/base/path"
      ]
    }
  }
}

Project Info

Created At

a year ago

Updated At

a year ago

Author Name

cdgaete

Star

Language

License

Recommend Servers

View All

ContextBridge

@tijuthomas5

ContextBridge (CB) is a local-first retrieval layer that sits between your codebase and your AI coding agent. Instead of pasting raw source files into context or letting the AI guess which files matter, CB indexes your codebase's real structure (via Graphify) and returns a compact, ranked result — owner file, related files, key symbols, and dependency chains — grounded in your actual code. A typical response is ~4–8 KB instead of the 100+ KB of raw source an AI would otherwise need to read to answer the same question — roughly a 96% cut in input tokens sent to your cloud AI, with zero hallucinated file paths or method names.

13 days ago

EdgeOne Pages MCP

@TencentEdgeOne

An MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

TypeScript

a year ago

MCP Advisor

@istarwyh

MCP Advisor & Installation - Use the right MCP server for your needs

TypeScript

a year ago

Malta Payments Mcp

@junter1989k-ai

12 days ago

Perplexity Ask MCP Server

@ppl-ai

A Model Context Protocol Server connector for Perplexity API, to enable web search without leaving the MCP ecosystem.

JavaScript

a year ago

Kazakhstan Payments Mcp

@junter1989k-ai

12 days ago

Tavily Mcp

@tavily-ai

JavaScript

a year ago

12 days ago

GBOX provides environments for AI Agents to operate computer and mobile devices. Mobile Scenario: Your agents can use GBOX to develop/test android apps, or run apps on the Android to complete various tasks(mobile automation). Desktop Scenario: Your agents can use GBOX to operate desktop apps such as browser, terminal, VSCode, etc(desktop automation). MCP: You can also plug GBOX MCP to any Agent you like, such as Cursor, Claude Code. These agents will instantly get the ability to operate computer and mobile devices.

a year ago

12 days ago

百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。

a year ago

Algeria Payments Mcp

@junter1989k-ai

12 days ago

Guatemala Payments Mcp

@junter1989k-ai

12 days ago

EverArt

@modelcontextprotocol

AI image generation using various models

a year ago

Arcgis Portal Mcp

@Asem-D

MCP server for ArcGIS Portal and ArcGIS Online. Lets AI assistants search content, query feature layers, manage features, handle content operations, and administer users and groups. Built on the Model Context Protocol for integration with Claude Desktop, Cursor, VS Code Copilot, and other MCP clients. Disclaimer: This is an independent open-source project. It is not affiliated with, endorsed by, or sponsored by Esri Inc. "ArcGIS" is a registered trademark of Esri.

12 days ago

MCP Server for Milvus

@zilliztech

The Milvus MCP server enables AI applications to interact with Milvus vector databases using natural language commands. It allows AI models to perform vector searches, manage collections, and retrieve data without writing custom database queries. This integration facilitates seamless access to vector data, enhancing the capabilities of AI tools like Claude Desktop and Cursor.

a year ago

Qatar Payments Mcp

@junter1989k-ai

12 days ago

Sentry

@modelcontextprotocol

Retrieving and analyzing issues from Sentry.io

a year ago

Costa Rica Payments Mcp

@junter1989k-ai

12 days ago

Filesystem