Repomapper

🚀 RepoMap - コマンドラインツールとMCPサーバー

RepoMapは、主に大規模言語モデル（LLMs）が複雑なコードベースを理解し、ナビゲートするのを支援するために設計された強力なツールです。このツールは、オンデマンドで分析を行うコマンドラインアプリケーションとして機能するだけでなく、MCP（Model Context Protocol）サーバーとしても動作し、他のアプリケーションに継続的なリポジトリマッピング機能を提供します。ソフトウェアリポジトリの「マップ」を生成することで、重要なファイル、コード定義、およびそれらの関係を強調表示します。正確なコード解析にはTree-sitterを利用し、コード要素を重要度でランク付けするためにPageRankアルゴリズムを使用し、常に最も関連性の高い情報が優先されるようにしています。

📚 目次

• Aider
• 出力例
• 主な機能
• インストール
• 使用方法
  • 基本的な使用法
  • 高度なオプション
• 動作原理
• 出力形式
• 依存関係
• キャッシュ
• サポートされる言語
• ライセンス
• MCPサーバーとしての実行
  • セットアップ
  • 使用方法
• 変更履歴

🧐 Aider

RepoMapは、100％Aiderのリポマップ機能に基づいていますが、コードは共有していないと思われます。説明させてください。

最初は、AiderからRepoMapクラスを取り出し、すべてのaider固有の依存関係を削除してから、コマンドラインツールにすることを試みました。Pythonは私の得意な言語ではなく、動作させるのに苦労しました。

数時間前に、別のアイデアが浮かびました。AiderからRepoMapとその関連コードの一部を取り出し、LLM（ClaudeまたはGemini 2.5 Pro、記憶が曖昧です）に渡し、Aiderの実装を元に仕様を作成させました。その結果、このアプリケーションの非常に詳細な仕様（MCPの部分を除く）が生成され、それをClaude 3.7を搭載したAiderに渡して、コマンドラインバージョンを構築しました。

その後、Claude 3.7を搭載したAider、Gemini 2.5 Pro PreviewとGemini 2.5 Flash Previewを搭載したCline、Phind.com、Gemini.com、Claude.com、ChatGPT.comを組み合わせて使用し、数時間後にようやくMCPサーバーを整えました。繰り返しになりますが、Pythonは私の得意な言語ではありません。

💻 出力例

> python repomap.py . --chat-files repomap_class.py
Chat files: ['/mnt/programming/RepoMapper/repomap_class.py']
repomap_class.py:
(Rank value: 10.8111)

  36: CACHE_VERSION = 1
  39: TAGS_CACHE_DIR = os.path.join(os.getcwd(), f".repomap.tags.cache.v{CACHE_VERSION}")
  40: SQLITE_ERRORS = (sqlite3.OperationalError, sqlite3.DatabaseError)
  43: Tag = namedtuple("Tag", "rel_fname fname line name kind".split())
  46: class RepoMap:
  49:     def __init__(
  93:     def load_tags_cache(self):
 102:     def save_tags_cache(self):
 459:     def get_ranked_tags_map_uncached(
 483:         def try_tags(num_tags: int) -> Tuple[Optional[str], int]:
 512:     def get_repo_map(

utils.py:
(Rank value: 0.2297)

  18: Tag = namedtuple("Tag", "rel_fname fname line name kind".split())
  21: def count_tokens(text: str, model_name: str = "gpt-4") -> int:
  35: def read_text(filename: str, encoding: str = "utf-8", silent: bool = False) -> Optional[str]:

importance.py:
(Rank value: 0.1149)

   8: IMPORTANT_FILENAMES = {
  27: IMPORTANT_DIR_PATTERNS = {
  34: def is_important(rel_file_path: str) -> bool:
  56: def filter_important_files(file_paths: List[str]) -> List[str]:

    ...
    ...
    ...

✨ 主な機能

• スマートなコード分析：Tree-sitterを使用してソースコードを解析し、関数やクラスの定義を抽出します。
• 関連性のランク付け：PageRankアルゴリズムを使用して、コード要素を重要度でランク付けします。
• トークン対応：トークン制限を尊重し、LLMのコンテキストウィンドウに収まるようにします。
• キャッシュ機能：永続的なキャッシュを使用して、後続の実行を高速化します。
• 多言語対応：Python、JavaScript、TypeScript、Java、C/C++、Go、Rustなどをサポートします。
• 重要ファイルの検出：重要なファイル（README、requirements.txtなど）を自動的に識別し、優先順位を付けます。

📦 インストール

pip install -r requirements.txt

💻 使用方法

基本的な使用法

# 現在のディレクトリをマッピング
python repomap.py .

# カスタムトークン制限で特定のディレクトリをマッピング
python repomap.py src/ --map-tokens 2048

# 特定のファイルをマッピング
python repomap.py file1.py file2.py

# チャットファイル（優先度が高い）とその他のファイルを指定
python repomap.py --chat-files main.py --other-files src/

# 言及されたファイルと識別子を指定
python repomap.py --mentioned-files config.py --mentioned-idents "main_function"

# 詳細な出力を有効にする
python repomap.py . --verbose

# キャッシュを強制的に更新する
python repomap.py . --force-refresh

# トークンカウント用のモデルを指定
python repomap.py . --model gpt-3.5-turbo

# 最大コンテキストウィンドウを設定
python repomap.py . --max-context-window 8192

# ページランクが0のファイルを除外する
python repomap.py . --exclude-unranked

このツールは、ファイルを以下の順序で優先します。

1. --chat-files：これらのファイルは最も高い優先度が与えられ、現在作業中のファイルと見なされます。
2. --mentioned-files：これらのファイルは高い優先度が与えられ、現在のコンテキストで明示的に言及されたファイルです。
3. --other-files：これらのファイルは最も低い優先度が与えられ、追加のコンテキストを提供するために使用されます。

高度なオプション

# 詳細な出力を有効にする
python repomap.py . --verbose

# キャッシュを強制的に更新する
python repomap.py . --force-refresh

# トークンカウント用のモデルを指定
python repomap.py . --model gpt-3.5-turbo

# 最大コンテキストウィンドウを設定
python repomap.py . --max-context-window 8192

# ページランクが0のファイルを除外する
python repomap.py . --exclude-unranked

# 特定のファイルまたは識別子を高い優先度で指定
python repomap.py . --mentioned-files config.py --mentioned-idents "main_function"

🔧 動作原理

1. ファイル探索：リポジトリ内のソースファイルをスキャンします。
2. コード解析：Tree-sitterを使用してコードを解析し、定義と参照を抽出します。
3. グラフ構築：ファイルをノードとし、シンボル参照をエッジとするグラフを作成します。
4. ランク付け：PageRankアルゴリズムを適用して、ファイルとシンボルを重要度でランク付けします。
5. トークン最適化：二分探索を使用して、最も重要なコンテンツをトークン制限内に収めます。
6. 出力生成：結果を読みやすいコードマップとしてフォーマットします。

📄 出力形式

このツールは、コードベースの構造化されたビューを生成し、以下の情報を表示します。

• ファイルパスと重要なコードセクション
• 関数とクラスの定義
• コード要素間の重要な関係
• 実際の使用状況と参照に基づいた優先順位付け

📌 依存関係

• tiktoken：様々なLLMモデルのトークンカウント
• networkx：グラフアルゴリズム（PageRank）
• diskcache：永続的なキャッシュ
• grep-ast：コード解析のためのTree-sitter統合
• tree-sitter：コード解析フレームワーク
• pygments：構文ハイライトと字句解析

💾 キャッシュ

このツールは、後続の実行を高速化するために永続的なキャッシュを使用します。

• キャッシュディレクトリ：.repomap.tags.cache.v1/
• ファイルが変更されたときに自動的に無効化されます。
• --force-refreshでクリアすることができます。

🌐 サポートされる言語

現在、Tree-sitterの文法がある言語をサポートしています。

• arduino
• chatito
• commonlisp
• cpp
• csharp
• c
• dart
• d
• elisp
• elixir
• elm
• gleam
• go
• javascript
• java
• lua
• ocaml_interface
• ocaml
• pony
• properties
• python
• racket
• r
• ruby
• rust
• solidity
• swift
• udev
• c_sharp
• hcl
• kotlin
• php
• ql
• scala

📄 ライセンス

この実装は、AiderプロジェクトのRepoMap設計に基づいています。

🚀 MCPサーバーとしての実行

RepoMapは、MCP（Model Context Protocol）サーバーとしても実行でき、他のアプリケーションがリポジトリマッピング機能にアクセスできるようにします。

セットアップ

1. RepoMapのMCPサーバーは、通信にSTDIO（標準入出力）を使用します。トランスポート層に追加の設定は必要ありません。
2. RepoMapをCline（またはRooなどの類似ツール）とともにMCPサーバーとして設定するには、Clineの設定ファイル（例：cline_mcp_settings.json）に以下の構成を追加します。

{
  "mcpServers": {
    "RepoMapper": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "/usr/bin/python3",
      "args": [
        "/absolute/path/to/repomap_server.py"
      ]
    }
  }
}

"/absolute/path/to/repomap_server.py"を、実際のrepomap_server.pyファイルのパスに置き換えてください。

使用方法

1. repomap_server.pyスクリプトを実行します。

python repomap_server.py

2. サーバーが起動し、STDIOを介してリクエストを待機します。
3. 他のアプリケーションは、サーバーが提供するrepo_mapツールを使用して、リポジトリマップを生成できます。マッピングしたいプロジェクトの絶対パスをproject_rootパラメータとして指定する必要があります。

📝 変更履歴

2025年7月13日 - project.jsonの依存関係を削除しました。MCPサーバーを修正し、LLMがファイル名を扱いやすくなるようにしました。