tearags - mcp：Git履歴を活用した大規模コードライブラリ対応のMCPコード検索ツール

Tearags MCP

TeaRAGsは、コーディングエージェント用に設計された意味的なコード検索MCPサーバーで、AST感知分塊と増分インデックスを通じて大規模なコードベースをサポートし、Git軌跡（コードの変更、作者情報、欠陥修正率など19の信号）を利用してスマートな再並べ替えを行い、従来の埋め込み類似度検索を超えます。

開発者ツール検索ツール #コード検索 #軌跡再並べ替え #意味検索 #増分インデックス .TypeScript

スコア : 2.5ポイント

ダウンロード数 : 7.4K

更新時間 : 2026-03-12

サイトを開く

TeaRAGsとは？

TeaRAGsは、コード検索用に特別に設計されたスマートアシスタントです。従来のコード検索ツールとは異なり、コードの意味的な意味を理解するだけでなく、コードの進化履歴も分析できます。これは、コードを検索するときに、機能が似ているコードを見つけるだけでなく、どのコードがより安定しているか、どの作者が関連分野に精通しているか、どのコードの変更リスクが低いかを教えてくれます。

TeaRAGsの使い方は？

TeaRAGsは、ClaudeなどのAIアシスタントを介して統合使用されます。まずサーバーを設定し、次にAIアシスタントを通じて検索命令を発行します。AIアシスタントにコードベース全体をインデックス化させ、「ユーザー認証を処理するコードを見つける」や「最近頻繁に変更されているAPIエンドポイントを表示する」などの質問をすることができます。システムは自動的にコードの意味と進化履歴を分析し、最も関連性の高い結果を返します。

適用シーン

1. 新しい開発者がコードベースに慣れる際に、関連するコード例をすばやく見つける 2. コードをリファクタリングする際に、安定した信頼できるコードテンプレートを識別する 3. バグを修正する際に、似た問題の解決策を探す 4. コードレビューの際に、コードの過去の変更状況を把握する 5. 技術的負債を評価する際に、高リスクのコード領域を識別する

主要機能

進化軌跡分析

コードのgit履歴を分析し、各関数の変更頻度、作者の変更、バグ修正記録など19種類の進化信号を追跡し、コードの安定性と信頼性を理解するのに役立ちます。

スマートな意味検索

コードの意味的な意味に基づいて検索を行い、関数、クラス、変数の実際の機能を理解することができ、単なるキーワードマッチングだけでなくなります。

ASTスマート分塊

抽象構文木（AST）を使用してコードを意味のあるブロック（関数、クラスなど）にスマートに分割し、検索結果の完全性を確保します。

スマートな結果再並べ替え

複数の事前設定された再並べ替え戦略を提供します：ホットスポット（hotspots）、コードの所有権（ownership）、技術的負債（techDebt）、セキュリティ監査（securityAudit）など、異なるシーンに応じて結果を最適化します。

多モデルサポート

ローカルモデル（Ollama）とクラウドモデル（OpenAI、Cohere、Voyage）をサポートし、ユーザーは必要に応じて柔軟に選択できます。

増分インデックス

大規模なコードベースの増分更新をサポートし、変更部分のみをインデックス化して効率を向上させます。

利点

コードの進化履歴をスマートに理解し、より信頼できる検索結果を提供する

ローカルデプロイをサポートし、コードのプライバシーとセキュリティを保護する

主流のAIアシスタント（Claude）とシームレスに統合され、使いやすい

オープンソースで無料で、機能をカスタマイズして拡張できる

大規模なコードベースを処理する能力が強く、百万行のコードをサポートする

制限

設定とデプロイが必要で、非技術ユーザーには一定の敷居がある

初めて大型のコードベースをインデックス化するには長い時間がかかる

git履歴データに依存しており、新しく作成されたプロジェクトでは効果が限られる

一定の計算リソース（CPU/メモリ）が必要である

現在は主に一般的なプログラミング言語をサポートしている

使い方

環境準備

必要なソフトウェアをインストールします：Node.js、Docker/Podman、Git。システムに十分なメモリとストレージがあることを確認します。

ダウンロードとインストール

プロジェクトのリポジトリをクローンし、依存パッケージをインストールします。

サービスの起動

Docker Composeを使用して必要なデータベースとモデルサービスを起動します。

AIアシスタントの設定

TeaRAGsサーバーをClaude CodeなどのAIアシスタントに追加します。

使用開始

AIアシスタントを通じて命令を送信してコードをインデックス化し、検索します。

使用例

ケース1：新しい開発者がコードベースに慣れる

新しくチームに加入した開発者は、ユーザー認証モジュールの実装方法をすばやく理解する必要があります。

ケース2：技術的負債をリファクタリングする

チームは、高リスクのコード領域を識別してリファクタリングする必要があります。

ケース3：コードレビューの支援

コードレビューの際に、レビュー対象のコードの過去の背景を把握します。

ケース4：コードテンプレートを探す

新しいREST APIエンドポイントを実装する必要があり、既存のベストプラクティスを参考にします。

よくある質問

TeaRAGsは通常のコード検索ツールと何が違いますか？

これを使用するにはプログラミング経験が必要ですか？

どのプログラミング言語をサポートしていますか？

私のコードデータは安全ですか？

大型のコードベースをインデックス化するのにどれくらい時間がかかりますか？

git履歴のないプロジェクトで使用できますか？

🚀 Beads - AIネイティブなイシュー追跡ツール

Beadsへようこそ！このリポジトリでは、Beads をイシュー追跡に使用しています。Beadsは、コードベース内に直接存在し、コードと一緒に動作する、最新のAIネイティブなツールです。

🚀 クイックスタート

必須コマンド

# 新しいイシューを作成
bd create "Add user authentication"

# すべてのイシューを表示
bd list

# イシューの詳細を表示
bd show <issue-id>

# イシューのステータスを更新
bd update <issue-id> --status in_progress
bd update <issue-id> --status done

# Gitリモートと同期
bd sync

イシューの操作

Beadsのイシューは以下の特徴があります。

Gitネイティブ：.beads/issues.jsonl に保存され、コードと同じように同期されます。
AIフレンドリー：CLIを中心とした設計で、AIコーディングエージェントと完璧に連携します。
ブランチ対応：イシューはブランチのワークフローに追従することができます。
常に同期：コミットと自動的に同期されます。

✨ 主な機能

✨ AIネイティブな設計

AI支援開発ワークフローに特化して構築されています。
CLIを中心としたインターフェースがAIコーディングエージェントとシームレスに連携します。
Web UIへのコンテキスト切り替えが不要です。

🚀 開発者中心の設計

イシューはコードのすぐ隣のリポジトリ内に存在します。
オフラインでも動作し、プッシュ時に同期されます。
高速で軽量で、開発の邪魔になりません。

🔧 Gitとの統合

Gitコミットと自動的に同期されます。
ブランチ対応のイシュー追跡が可能です。
インテリジェントなJSONLマージ解決機能があります。

📦 インストール

Beadsを自分のプロジェクトで試してみましょう。

# Beadsをインストール
curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash

# リポジトリで初期化
bd init

# 最初のイシューを作成
bd create "Try out Beads"