AI导哈

目录探索与分析服务

TokenScope 是一个基于模型上下文协议（MCP）的服务，专为大型语言模型（LLMs）设计，提供智能目录结构分析和令牌感知的文件内容探索功能。它能够帮助LLMs如Claude理解代码库和目录结构，通过扫描目录结构、提取和分析文件内容、生成报告等功能，提高代码库的理解效率。

  • by cdgaete
  • 更新于
在 GitHub 查看 cdgaete/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

相关 MCP