基本能力
产品定位
TokenScope 是一个专为大型语言模型设计的目录探索与分析工具，提供智能的目录结构分析和令牌感知的文件内容探索功能。
核心功能
- 令牌感知目录扫描：递归探索目录，提供智能摘要，支持自定义忽略模式。
- 文件内容分析：智能提取文件内容，尊重令牌限制，优先处理重要文件。
- 令牌使用统计：估算处理目录所需的令牌，按文件扩展名分类统计。
- 综合报告生成：生成包含目录结构、令牌使用统计和重要文件样本的Markdown报告。
适用场景
- 代码库结构分析与理解
- 文件内容智能提取与摘要生成
- 令牌使用统计与优化
使用教程
使用依赖
- Python 3.10 或更高版本
- uv（推荐用于依赖管理）
安装教程
主安装（PyPI）
uv pip install tokenscope运行TokenScope
uv run --with tokenscope tokenscope --base-path /path/to/allowed/directory在Claude Desktop中配置
- 定位Claude Desktop的配置文件（通常在
~/.config/claude/config.json） - 在
mcpServers部分添加TokenScope配置 - 替换
/your/secure/base/path为安全目录路径 - 保存配置文件并重启Claude Desktop
调试方式
开发安装（从GitHub）
git clone https://github.com/cdgaete/directory-explorer-mcp.git
cd directory-explorer-mcp
uv pip install -e ".[dev]"运行开发模式
uv run --with fastmcp --with tiktoken server.py --base-path /path/to/allowed/directory