HS

haacked/spelungit

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

29 stars 2 forks 품질 65 트렌드 0MIT

MCP 서버는 자연 언어를 사용하여 git 역사를 검색합니다

개요

Model Context Protocol (MCP) 서버는 Semantic 검색을 사용하여 Git 커밋 역사를 탐구합니다. "Search git history"와 같은 자연적인 언어 명령으로 커밋을 통해 왜이 클래스가 추가되었는지 알아보세요?" - : Git 커밋 역사에 대한 자연적인 언어 쿼리 - : 자동적으로 검출하고 다른 저장소 - : SQLite + 로컬 embeddings를 가진 상자에서 작동 - : 코드 변경 및 기술 콘텐츠에 최적화 된 하이브리드 embeddings - : 손잡이 복잡 worktrees를 포함한 Git 설정 - : Claude Code의 자동 구성 - 다운로드 Spelungit을 자동으로 설치 - 파이썬 가상 환경을 설정 - 종단 코드를 자동으로 구성 - 설치 의존성 (지속성 트랜스포머, SQLite, numpy) - 설치 개발자 또는 사용자가 저장소를 복제하려면: Claude Code 구성 추가 (~/.config/claude/claude desktop config.json): 1. - 자연 언어 2. - 검색에 대한 저장소를 색인 3.

개요(AI 번역)

Git 커밋 역사를 탐구하는 모델 Context Protocol (MCP) 서버 semantic 검색. 자연적인 언어 명령과 함께 커밋을 통해 검색 "이 클래스가 왜 추가되었는지 알아내는 git 역사?

✨ 특징

  • ** 배열 검색**: Git 커밋 역사에 대한 자연적인 언어 쿼리
  • ** 本 멀티 저장소 지원**: 자동 감지 및 다른 저장소를 격리
  • ** Zero-Config 설치 : SQLite + 로컬 embeddings로 상자에서 작동합니다. -A Code-Aware Search: 코드 변경 및 기술 콘텐츠에 최적화된 Hybrid embedding - G Git Worktree 지원**: 손잡이 단지 worktrees를 포함한 Git 설정 -► Claude Code Integration: Claude Code의 자동 구성

⭐ 빠른 설치

** One-line 설치 ** (최종 사용자에 대한 권장):

이 명령은:

  • 다운로드 및 Spelungit을 자동으로 설치
  • Python 가상 환경 설정
  • 종속성 설치 (sentence-transformers, SQLite, numpy)
  • Claude Code를 자동으로 구성
  • 설치 테스트

Requirements: 파이썬 3.8+ 및 컬/ 위젯

炉端串 설치

옵션 1: 복제 및 설치

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

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")
GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

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