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

11 days ago

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

TypeScript

a year ago

Aws Kb Retrieval Server

@modelcontextprotocol

An MCP server implementation for retrieving information from the AWS Knowledge Base using the Bedrock Agent Runtime.

a year ago

Aiimagemultistyle

@codecraftm

A Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

a year ago

Slack

@modelcontextprotocol

Channel management and messaging capabilities

a year ago

Redis

@modelcontextprotocol

A Model Context Protocol server that provides access to Redis databases. This server enables LLMs to interact with Redis key-value stores through a set of standardized tools.

a year ago

11 days ago

基于Anduin2017 / HowToCook （程序员在家做饭指南）的mcp server，帮你推荐菜谱、规划膳食，解决“今天吃什么“的世纪难题； Based on Anduin2017/HowToCook (Programmer's Guide to Cooking at Home), MCP Server helps you recommend recipes, plan meals, and solve the century old problem of "what to eat today"

a year ago

Neon MCP Server

@neondatabase-labs

MCP server for interacting with Neon Management API and databases

TypeScript

a year ago

AgentQL MCP Server

@tinyfish-io

Model Context Protocol server that integrates AgentQL's data extraction capabilities.

JavaScript

a year 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

Memory

@modelcontextprotocol

a year ago

Tavily Mcp

@tavily-ai

JavaScript

a year ago

302_browser_use_mcp

@302ai

Automatically create a remote browser to complete your specified tasks, developed based on Browser Use + Sandbox. 自动创建一个远程浏览器，完成你指定的任务，基于Browser Use + Sandbox开发。

a year ago

Kazakhstan Payments Mcp

@junter1989k-ai

11 days ago

mcp-server-flomo MCP Server

@chatmcp

Write notes to Flomo

JavaScript

a year ago

Github

@modelcontextprotocol

Repository management, file operations, and GitHub API integration

a year ago

Cyprus Payments Mcp

@junter1989k-ai

11 days ago

Mailtrap Email Sending MCP

@Mailtrap

An MCP server that provides a tool for sending transactional emails via Mailtrap

a year ago

Amap Maps

@amap

高德地图官方 MCP Server

a year ago

GBOX Android MCP

@babelcloud

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

Filesystem

Secure file operations with configurable access controls

a year ago

11 days ago

11 days ago

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

TypeScript

a year ago

Frontrun

@jongall45

VC follow intelligence for AI agents. Track what top investors follow on X — detect new follows, convergence signals, and trending companies before they're announced.

6 days ago

PostgreSQL

@modelcontextprotocol

Read-only database access with schema inspection

a year ago

11 days ago

summarize chat message

typescript

a year ago

GitLab

@modelcontextprotocol

GitLab API, enabling project management

a year ago