🦞 MCP Git Enhanced

Улучшенный MCP-сервер (Model Context Protocol) для Git, предоставляющий ИИ-ассистентам мощные возможности для проверки кода, анализа коммитов и управления ветками.

Функции

• 🔍 Анализ diff кода - Сравнение коммитов, веток или изменений в рабочей директории

• 📊 Анализ истории коммитов - Глубокое понимание паттернов коммитов и участников

• 🌿 Управление ветками - Список, сравнение и рекомендации по очистке

• 📈 Статус репозитория - Комплексный обзор рабочей директории

• 🔎 Анализ коммитов - Детальная проверка отдельного коммита

Related MCP server: pr-mcp-server

Установка

Из npm (после публикации)

npm install -g @bountyclaw/mcp-git-enhanced

Из исходного кода

git clone https://github.com/bountyclaw/mcp-git-enhanced.git
cd mcp-git-enhanced
npm install
npm run build

Использование с Claude Code

Добавьте в конфигурацию Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "git-enhanced": {
      "command": "npx",
      "args": ["@bountyclaw/mcp-git-enhanced"]
    }
  }
}

Или для локальной разработки:

{
  "mcpServers": {
    "git-enhanced": {
      "command": "node",
      "args": ["/path/to/mcp-git-enhanced/dist/index.js"]
    }
  }
}

Доступные инструменты

git_diff

Анализ изменений кода между коммитами, ветками или рабочей директорией.

{
  "repoPath": "/absolute/path/to/repo",
  "target": "HEAD~5",
  "source": "HEAD~10",
  "filePath": "src/",
  "staged": false
}

git_log

Анализ истории коммитов с фильтрацией и статистикой.

{
  "repoPath": "/absolute/path/to/repo",
  "maxCount": 20,
  "author": "John Doe",
  "since": "1 week ago",
  "stat": true
}

git_branch

Управление и анализ веток git.

{
  "repoPath": "/absolute/path/to/repo",
  "action": "list|compare|suggest_cleanup",
  "includeRemote": true
}

git_status

Получение комплексного статуса репозитория.

{
  "repoPath": "/absolute/path/to/repo",
  "short": false
}

git_commit_analyze

Детальный анализ конкретного коммита.

{
  "repoPath": "/absolute/path/to/repo",
  "commitHash": "abc123"
}

Примеры использования

Проверка кода

"Show me the diff between main and the feature branch"
"What files changed in the last 5 commits?"
"Analyze the impact of commit abc123"

Состояние репозитория

"List all branches that can be safely deleted"
"Show me commits from the last week"
"Who are the top contributors to this project?"

Рабочая директория

"What's the current status of my repo?"
"Show me the staged changes"
"What files have uncommitted changes?"

Разработка

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Test locally
node dist/index.js

Тестирование

Этот проект использует Jest для тестирования с полным покрытием всех обработчиков инструментов Git.

# Run all tests
npm test

# Run tests with coverage report
npm run test:coverage

# Run tests in watch mode
npm run test:watch

Отчет о покрытии

Структура тестов

• src/__tests__/tools.test.ts - Модульные тесты для всех 5 обработчиков инструментов Git

  • git_diff - 7 тестовых случаев

  • git_log - 13 тестовых случаев

  • git_branch - 10 тестовых случаев (список, сравнение, suggest_cleanup)

  • git_status - 5 тестовых случаев

  • git_commit_analyze - 4 тестовых случая

Качество кода

# Run ESLint
npm run lint

# Fix ESLint issues
npm run lint:fix

# Format with Prettier
npm run format

# Check formatting
npm run format:check

Требования

• Node.js >= 18.0.0

• Git установлен и доступен в PATH

Лицензия

MIT

Участие в разработке

Приветствуются любые вклады! Пожалуйста, ознакомьтесь с CONTRIBUTING.md для получения подробной информации.

Создано с 🦞 компанией BountyClaw