Directory Explorer MCP

基本能力

产品定位

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中配置

1. 定位Claude Desktop的配置文件（通常在~/.config/claude/config.json）
2. 在mcpServers部分添加TokenScope配置
3. 替换/your/secure/base/path为安全目录路径
4. 保存配置文件并重启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