Directory Explorer MCP Server

トークンスコープ

**注意:**このパッケージはtokenscopeとして公開されていますが、歴史的な理由によりリポジトリ名はdirectory-explorer-mcpのままです。

大規模言語モデル (LLM) 向けに設計された、トークン対応のディレクトリ探索および分析用のモデル コンテキスト プロトコル (MCP)サーバー。

概要

TokenScopeは、インテリジェントなディレクトリ構造分析とトークンを考慮したファイルコンテンツ探索機能を提供します。ClaudeのようなLLMがコードベースとディレクトリ構造を理解するのに役立ちます。

1. トークン効率の高い要約によるディレクトリ構造のスキャン
2. トークン認識によるファイル内容の抽出と分析
3. コードベースを理解するための重要なファイルを見つける
4. 関連情報を含むレポートの生成

特徴

• トークン対応ディレクトリスキャン
  • 設定可能な深さでディレクトリを再帰的に探索します
  • 大規模なディレクトリにインテリジェントな概要を提供します
  • .gitignore ファイルとカスタム無視パターンを尊重
• ファイルコンテンツ分析
  • トークン制限を尊重したファイル内容のスマートな抽出
  • JSONおよびその他の構造化ファイルの特別な処理
  • 重要度に基づくファイル選択の優先順位付け
• トークン使用統計
  • ディレクトリの処理に必要なトークンを推定します
  • ファイル拡張子別にトークンの使用状況を分類します
  • トークンの多いファイルを識別します
• 包括的なレポート
  • ディレクトリ構造を持つマークダウンレポートを生成する
  • トークンの使用統計情報が含まれています
  • 重要なファイルのサンプルを表示します

インストール

前提条件

• Python 3.10以上
• uv (依存関係の管理を容易にするために推奨)

1. メインインストール（PyPI）

これは、TokenScope のみを使用したいほとんどのユーザーに推奨される方法です。

TokenScopeの実行

--base-path引数はセキュリティ上の理由から必須です。これにより、すべてのファイル操作が指定されたディレクトリに制限されます。

Claude Desktopでの設定

1. Claude Desktop の設定ファイルを見つけます (通常は~/.config/claude/config.jsonにあります)
2. TokenScope をmcpServersセクションに追加します。
   "mcpServers": { "TokenScope": { "command": "uv", "args": [ "run", "--with", "tokenscope", "tokenscope", "--base-path", "/your/secure/base/path" ] } }
3. /your/secure/base/path操作を制限したいディレクトリに置き換えます。
4. 設定ファイルを保存し、Claude Desktopを再起動します。

2. 開発インストール（GitHubから）

コードを変更したい貢献者またはユーザーの場合:

開発モードで実行

Claude Desktopで開発バージョンを構成する

1. Claude Desktopの設定ファイルを見つける
2. 開発パスを使用して、 mcpServersセクションに TokenScope を追加します。
   "mcpServers": { "TokenScope (Dev)": { "command": "uv", "args": [ "run", "--with", "fastmcp", "--with", "tiktoken", "/path/to/your/directory-explorer-mcp/server.py", "--base-path", "/your/secure/base/path" ] } }
3. /path/to/your/directory-explorer-mcp/server.pyを server.py ファイルへの実際のパスに置き換えます。
4. /your/secure/base/pathセキュアディレクトリに置き換えます

セキュリティ機能

--base-path引数はセキュリティ上の理由から必須です。

• すべてのファイル操作は、指定されたディレクトリ内にあることを確認するために検証されます。
• ベースパス外のファイルにアクセスしたり変更したりする試みは拒否されます
• ベースパスはサーバーの起動時に一度設定され、再起動しないと変更できません。

プロンプトの例

Claude で TokenScope を使用する方法の例をいくつか示します。

利用可能なツール

サーバーは次の MCP ツールを提供します。

scan_directory_structure

ディレクトリをスキャンし、トークン効率の高い方法でその構造を返します。

extract_file_content

トークンの制限と形式を尊重しながら、特定のファイルの内容を抽出します。

search_files_by_pattern

ディレクトリ構造内で指定されたパターンに一致するファイルを検索します。

analyze_token_usage

ディレクトリまたはファイルのトークンの使用状況を分析して、LLM 処理要件を推定します。

copy_file_to_destination

ソース パスから宛先パスにファイルをコピーします。

generate_directory_report

トークン統計を含むディレクトリに関する包括的なマークダウン レポートを生成します。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

謝辞

• FastMCPで構築
• この同じコンセプトは元々はrepoaiで実装されました
• LLMを使用してコードベースを効率的に分析する必要性に着想を得て