Sheriff-MCP

Sheriff — это MCP-сервер, который помогает ИИ-агентам эффективно исправлять проблемы статического анализа из SARIF-отчётов.

Документация | Установка | Справочник инструментов

Почему Sheriff?

ИИ-агенты с трудом справляются с большими отчётами статического анализа:

• Перегрузка контекста - 100+ проблем переполняют окна контекста

• Потеря прогресса - работа теряется при сжатии контекста или перезапуске сеанса

• Неэффективная навигация - отсутствие пакетной обработки означает многократные переключения между файлами

Sheriff решает эту проблему, действуя как менеджер очереди задач:

• Интеллектуальная пакетная обработка - проблемы группируются по файлам для эффективного исправления

• Постоянный прогресс - состояние сохраняется при сжатии контекста, перезапусках и смене агентов

• Фильтрация области - сосредоточьтесь на конкретных правилах, уровнях серьёзности или шаблонах файлов

• Компактные ответы - минимальное использование контекста с сокращёнными именами полей

Поддерживаемые инструменты статического анализа

Sheriff работает с любым инструментом, который создаёт вывод в формате SARIF:

Related MCP server: skillhub

Быстрый старт

1. Установка

Скачайте sheriff-mcp-1.0.2-all.jar со страницы Релизы.

docker pull ghcr.io/ryansmith4/sheriff-mcp:latest

Клиенты, поддерживающие MCP Registry, могут установить его напрямую по имени: io.github.ryansmith4/sheriff-mcp.

Подробную информацию см. в руководстве по установке.

2. Настройка MCP-клиента

Добавьте Sheriff в свой MCP-клиент (Claude Code, Cursor, ChatGPT Desktop и т. д.):

{
  "mcpServers": {
    "sheriff": {
      "command": "java",
      "args": ["-jar", "/path/to/sheriff-mcp-1.0.2-all.jar", "start"]
    }
  }
}

Или с помощью Docker:

{
  "mcpServers": {
    "sheriff": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-v", ".:/data", "ghcr.io/ryansmith4/sheriff-mcp:latest"]
    }
  }
}

Инструкции для конкретных клиентов и рекомендуемые инструкции для агентов приведены в руководстве по настройке агентов.

3. Использование

1. Run static analysis     →  qodana scan
2. Load into Sheriff       →  sheriff load target="results.sarif"
3. Get next file's issues  →  sheriff next
4. Fix all issues in file  →  [edit the code]
5. Mark as done            →  sheriff done fps=[...] status="fixed"
6. Repeat 3-5              →  until remaining = 0

Sheriff предоставляет один инструмент sheriff с 7 действиями: load, next, done, progress, summary, reopen и export. Полную документацию см. в справочнике инструментов.

Пример сеанса

User: "Fix all ConstantValue issues in my codebase"

Agent: sheriff load target="build/qodana/qodana.sarif.json"
       → 136 total issues, 22 ConstantValue, 15 unused...

Agent: sheriff next scope={rule: "ConstantValue"}
       → 3 issues in Service.java with code snippets

Agent: [reads Service.java, fixes all 3 issues]

Agent: sheriff done fps=["88d32cab35478753", "ab1c2d3e12345678", "f9e8d7c6a1b2c3d4"] status="fixed"
       → 3 marked fixed, 19 remaining

       ... continues until remaining = 0

Безопасность

Все артефакты релизов подписаны с помощью Sigstore для безопасности цепочки поставок.

Проверка JAR:

VERSION=1.0.2
cosign verify-blob \
  --signature sheriff-mcp-${VERSION}-all.jar.sig \
  --certificate sheriff-mcp-${VERSION}-all.jar.pem \
  --certificate-identity-regexp "https://github.com/ryansmith4/sheriff-mcp" \
  --certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
  sheriff-mcp-${VERSION}-all.jar

Проверка Docker-образа:

cosign verify ghcr.io/ryansmith4/sheriff-mcp:latest \
  --certificate-oidc-issuer=https://token.actions.githubusercontent.com \
  --certificate-identity-regexp="github.com/ryansmith4/sheriff-mcp"

Нашу политику безопасности см. в SECURITY.md.

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

Приветствуется любой вклад! Рекомендации см. в CONTRIBUTING.md.

Лицензия

Apache License 2.0 — см. LICENSE