TokenScope: Token-Aware Directory Explorer

Name: TokenScope: Token-Aware Directory Explorer
Author: cdgaete

@cdgaete

TokenScope: Token-Aware Directory Explorer について

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 #explorer #claude #ai #assistant #token-aware

基本情報

カテゴリ

ファイルとストレージ

トランスポート

stdio

公開者

cdgaete

投稿者

Carlos Gaete

設定

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

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

ツール

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

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

概要

What is TokenScope: Token-Aware Directory Explorer?

TokenScope is a Model Context Protocol (MCP) server that provides token-aware directory structure analysis and file content extraction for Large Language Models. It helps LLMs understand codebases efficiently by respecting token limits and filtering via .gitignore patterns.

How to use TokenScope: Token-Aware Directory Explorer?

Configure TokenScope with a mandatory base path for security, then invoke its six tools (e.g., scan_directory_structure, extract_file_content, search_files_by_pattern, analyze_token_usage, generate_directory_report, copy_file_to_destination) from any MCP-compatible client. All operations are confined to the allowed directory and automatically respect .gitignore rules.

Key features of TokenScope: Token-Aware Directory Explorer

Recursive directory scanning with token-efficient summaries
Smart file content extraction respecting token limits
Pattern-based file search within the allowed directory
Token usage estimation for entire directories
Comprehensive directory reports with structure and token statistics
Secure file copying between locations inside the base path

Use cases of TokenScope: Token-Aware Directory Explorer

Give an LLM structured context about a codebase before code generation
Extract relevant source files from a large project while staying under token budgets
Estimate the token cost of processing a directory with an LLM
Quickly locate files matching specific patterns in a project
Generate token-aware overviews of directory contents for AI-assisted development

FAQ from TokenScope: Token-Aware Directory Explorer

What is the base path and why is it required?

The base path is a mandatory directory that limits all file operations. It ensures security by confining scans, extractions, and copies to that directory only.

How does TokenScope handle token limits?

The server estimates token counts and uses smart extraction to stay within configurable token limits, providing only as much content as the LLM can process.

Does TokenScope respect .gitignore patterns?

Yes, it automatically filters out files and directories matched by .gitignore patterns in the scanned directory, reducing noise and saving tokens.

What are the runtime dependencies of TokenScope?

TokenScope is an MCP server; it requires a runtime environment with the MCP protocol and access to the filesystem it scans. No additional databases or external services are needed.

How secure is file copy in TokenScope?

The copy_file_to_destination tool operates exclusively within the allowed base path, preventing any file operations outside that directory. Destination files must also reside inside the base path.

「ファイルとストレージ」の他のコンテンツ

Filesystem MCP Server (@shtse8/filesystem-mcp)

shtse8

📁 Secure, efficient MCP filesystem server - token-saving batch operations with project root confinement

MCP docx server

h4ck4life

MCP server to manipulate DOCX file

Bulk Filesystem Operations MCP Server

strawgate

MCP Server for reading many files at the same time

PDF Reader MCP Server (@shtse8/pdf-reader-mcp)