广告合作
MCP.so
登录

TokenScope MCP Server

@cdgaete

代码仓库

基本信息

分类

文件与存储

许可证

MIT license

传输方式

stdio

作者

cdgaete

关于 TokenScope MCP Server

Token-Aware Directory Explorer MCP Server for LLMs like Claude

TokenScope MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "directory-explorer-mcp": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "tokenscope"
      ]
    }
  }
}

TokenScope MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is TokenScope?

TokenScope is a Model Context Protocol (MCP) server for token-aware directory exploration and analysis. It helps Large Language Models (LLMs) understand codebases by scanning directory structures with token-efficient summaries, extracting file contents with token awareness, finding important files, and generating comprehensive reports.

How to use TokenScope?

Install via uv pip install tokenscope (Python 3.10+ required). Run with the mandatory --base-path argument to restrict all file operations to a specific directory. For Claude Desktop, add the server to mcpServers in the configuration file (e.g., ~/.config/claude/config.json), providing the uv run command with required arguments. A development installation option from GitHub is also available.

Key features of TokenScope

  • Token-aware directory scanning with configurable depth and .gitignore support
  • Smart file content extraction respecting token limits
  • Token usage statistics broken down by file extension
  • Markdown report generation with structure and token statistics
  • File selection prioritization based on importance
  • Search files by pattern within directory structure

Use cases of TokenScope

  • Scanning a project directory to quickly understand its structure and key files
  • Estimating token consumption for processing a codebase with an LLM
  • Generating a comprehensive directory report including token statistics and file samples

常见问题

1

What is the mandatory argument for running TokenScope?

The `--base-path` argument is mandatory. It restricts all file operations to the specified directory for security; attempts to access files outside this path are rejected.

2

How do I configure TokenScope in Claude Desktop?

Add the server to the `mcpServers` section of Claude Desktop's configuration file. Example: `"TokenScope": { "command": "uv", "args": ["run", "--with", "tokenscope", "tokenscope", "--base-path", "/your/secure/base/path"] }`.

3

What are the dependencies and runtime requirements?

Python 3.10 or higher is required. The recommended package manager is `uv`. For development, `fastmcp` and `tiktoken` are additional dependencies.

4

Does TokenScope store any data or communicate externally?

The README does not mention any data storage or external communication. All operations are file-system based within the allowed base path.

5

What MCP tools does TokenScope provide?

It provides six tools: `scan_directory_structure`, `extract_file_content`, `search_files_by_pattern`, `analyze_token_usage`, `copy_file_to_destination`, and `generate_directory_report`.

评论

文件与存储 分类下的更多 MCP 服务器

Google Drive

modelcontextprotocol

Model Context Protocol Servers

88.1K

box-mcp-server

hmk

A Box model context protocol server to search, read and access files

11

HTMLvault

AI tools (Claude, ChatGPT, Gemini, Grok, etc.) generate HTML constantly, from reports to landing pages to prototypes, but there's no easy way to share it or know if anyone looked. HTMLvault turns any HTML into a clean, t

Filesystem

chrisdoc

Manage your Hevy workouts, routines, folders, and exercise templates. Create and update sessions faster, organize plans, and search exercises to build workouts quickly. Stay synced with changes so your training log is always up to date.

310

Filesystem MCP Server SSE

ysthink

The SSE version of the MCP service is modified from the Filesystem MCP server

17
广告合作