Gitのコミット履歴を探索するためのモデルコンテキストプロトコル(MCP)サーバー セマンティック検索。 自然言語のコマンドでコミットを検索する 「このクラスがなぜ追加されたのかを調べるために、git履歴を検索しますか?」

✨ 機能

• ** 定常検索**: Gitコミット履歴上の自然言語クエリ
• ** 複数行リポジトリサポート**: 自動的に検出し、異なるリポジトリを分離する
• ** ⚡ ゼロ構成のインストール**: SQLite +ローカルの埋め込みでボックスから動作します
• ** 参照コード-Aware Search**: コード変更と技術的なコンテンツのために最適化されたハイブリッド埋め込み
• ** Git Worktree サポート**: 複雑なハンドル ワークツリーを含むGitのセットアップ
• ** OST Claudeコードの統合**:Claudeコードの自動設定

OST クイックインストール

ワンラインインストール(エンドユーザー向けに推奨):

このコマンドは次のようになります:

• Spelungitを自動的にダウンロードしてインストールする
• Python仮想環境の設定
• 依存関係(sentence-transformers、SQLite、numpy)をインストールする
• Claude コードを自動的に構成する
• インストールをテストして下さい

要求: Python 3.8+とcurl/wget

384 高度なインストール

##Option 1: クローンとインストール

Spelungit MCP Server

A Model Context Protocol (MCP) server for exploring Git commit history using semantic search. Search through commits with natural language commands like “Search git history to find out why was this class added?”

✨ Features

• 🔍 Semantic Search: Natural language queries over Git commit history
• 🌳 Multi-Repository Support: Automatically detects and isolates different repositories
• ⚡ Zero-Config Installation: Works out of the box with SQLite + local embeddings
• 🎯 Code-Aware Search: Hybrid embeddings optimized for code changes and technical content
• 📊 Git Worktree Support: Handles complex Git setups including worktrees
• 🚀 Claude Code Integration: Automatic configuration for Claude Code

🚀 Quick Install

One-line installation (recommended for end users):

curl -sSL https://raw.githubusercontent.com/haacked/spelungit/main/install-remote.sh | bash

This command will:

• Download and install Spelungit automatically
• Set up a Python virtual environment
• Install dependencies (sentence-transformers, SQLite, numpy)
• Configure Claude Code automatically
• Test the installation

Requirements: Python 3.8+ and curl/wget

🔧 Advanced Installation

Option 1: Clone and Install

For developers or users who prefer to clone the repository:

git clone https://github.com/haacked/spelungit.git
cd spelungit
./install.sh

Option 2: Manual Installation

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Test the installation
python -m spelungit.server --test

Add to your Claude Code configuration (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "spelungit": {
      "command": "/path/to/venv/bin/python",
      "args": ["-m", "spelungit.server"],
      "env": {
        "PYTHONPATH": "/path/to/spelungit/src"
      }
    }
  }
}

📖 Usage

Available Tools

1. search_commits - Search commits using natural language
2. index_repository - Index a repository for search
3. repository_status - Check indexing status
4. get_database_info - View database statistics
5. search_blame - Search code blame data using natural language
6. who_wrote - Find authors who wrote code matching a query
7. configure_auto_update - Configure automatic index update behavior
8. get_auto_update_config - Get current automatic index update configuration

Example Queries

# Search for authentication-related changes
search_commits(query="authentication login changes", limit=5)

# Find database migration commits
search_commits(query="database schema migration", author_filter="john")

# Look for bug fixes
search_commits(query="fix error exception handling")

# Search blame information for specific code
search_blame(query="authentication middleware setup")