Skip to main content
Glama

Sheriff-MCP

CI OpenSSF Scorecard OpenSSF Best Practices License Java 21+ GitHub release

Sheriff는 AI 에이전트가 SARIF 보고서의 정적 분석 이슈를 효율적으로 수정하도록 돕는 MCP 서버입니다.

문서 | 설치 | 도구 참조


왜 Sheriff인가?

AI 에이전트는 대규모 정적 분석 보고서를 처리하는 데 어려움을 겪습니다:

  • 컨텍스트 과부하 - 100+ 이슈가 컨텍스트 창을 압도합니다

  • 진행 상황 손실 - 컨텍스트 압축이나 세션 재시작 시 작업이 손실됩니다

  • 비효율적인 탐색 - 일괄 처리가 없으면 파일 사이를 반복적으로 오가게 됩니다

Sheriff는 작업 큐 관리자 역할을 하여 이 문제를 해결합니다:

  • 지능형 일괄 처리 - 효율적인 수정을 위해 파일별로 이슈를 그룹화합니다

  • 지속적인 진행 상황 - 압축, 재시작, 에이전트 전환 후에도 상태가 유지됩니다

  • 범위 필터링 - 특정 규칙, 심각도 또는 파일 패턴에 집중합니다

  • 간결한 응답 - 축약된 필드 이름으로 컨텍스트 사용을 최소화합니다

지원되는 정적 분석 도구

Sheriff는 SARIF 출력을 생성하는 모든 도구와 함께 작동합니다:

도구

언어

SARIF 명령

Qodana

Java/Kotlin/JS/Python

qodana scan

Semgrep

다중 언어

semgrep --sarif -o results.sarif

ESLint

JavaScript/TypeScript

eslint --format @microsoft/sarif

CodeQL

다중 언어

내장 SARIF 출력

SpotBugs

Java

spotbugs -sarif

Bandit

Python

bandit -f sarif

Checkov

IaC

checkov -o sarif

Trivy

컨테이너/IaC

trivy --format sarif

SonarQube

다중 언어

내장 SARIF 내보내기


Related MCP server: CodePeel MCP Server

빠른 시작

1. 설치

Releases에서 sheriff-mcp-1.0.2-all.jar을(를) 다운로드하세요.

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

MCP Registry를 지원하는 클라이언트는 이름으로 직접 설치할 수 있습니다: io.github.ryansmith4/sheriff-mcp

자세한 내용은 설치 가이드를 참조하세요.

2. MCP 클라이언트 구성

MCP 클라이언트(Claude Code, Cursor, ChatGPT Desktop 등)에 Sheriff를 추가하세요:

{
  "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는 load, next, done, progress, summary, reopen, export의 7가지 액션으로 구성된 단일 sheriff 도구를 제공합니다. 전체 문서는 도구 참조를 참조하세요.


예제 세션

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 참조

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

Maintenance

ActivityNo data
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to scan GitHub repositories for security vulnerabilities, deployment blockers, and code quality issues. It provides detailed findings and auto-generated code patches to help developers ensure their code is production-ready.
    83
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to scan codebases for TODO/FIXME/XXX patterns and get prioritized results over MCP, supporting CI gates and multiple output formats.
    -
  • A
    license
    A
    quality
    B
    maintenance
    Enables AI agents to scan code for security vulnerabilities using multiple static analysis tools, with support for filtering, deduplication, and CI/CD integration.
    27
    2
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ryansmith4/sheriff-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server