Sheriff는 AI 에이전트가 SARIF 보고서의 정적 분석 이슈를 효율적으로 수정하도록 돕는 MCP 서버입니다.
AI 에이전트는 대규모 정적 분석 보고서를 처리하는 데 어려움을 겪습니다:
컨텍스트 과부하 - 100+ 이슈가 컨텍스트 창을 압도합니다
진행 상황 손실 - 컨텍스트 압축이나 세션 재시작 시 작업이 손실됩니다
비효율적인 탐색 - 일괄 처리가 없으면 파일 사이를 반복적으로 오가게 됩니다
Sheriff는 작업 큐 관리자 역할을 하여 이 문제를 해결합니다:
지능형 일괄 처리 - 효율적인 수정을 위해 파일별로 이슈를 그룹화합니다
지속적인 진행 상황 - 압축, 재시작, 에이전트 전환 후에도 상태가 유지됩니다
범위 필터링 - 특정 규칙, 심각도 또는 파일 패턴에 집중합니다
간결한 응답 - 축약된 필드 이름으로 컨텍스트 사용을 최소화합니다
Sheriff는 SARIF 출력을 생성하는 모든 도구와 함께 작동합니다:
도구 | 언어 | SARIF 명령 |
Qodana | Java/Kotlin/JS/Python |
|
Semgrep | 다중 언어 |
|
ESLint | JavaScript/TypeScript |
|
CodeQL | 다중 언어 | 내장 SARIF 출력 |
SpotBugs | Java |
|
Bandit | Python |
|
Checkov | IaC |
|
Trivy | 컨테이너/IaC |
|
SonarQube | 다중 언어 | 내장 SARIF 내보내기 |
Related MCP server: skillhub
Releases에서 sheriff-mcp-1.0.2-all.jar을(를) 다운로드하세요.
docker pull ghcr.io/ryansmith4/sheriff-mcp:latestMCP Registry를 지원하는 클라이언트는 이름으로 직접 설치할 수 있습니다: io.github.ryansmith4/sheriff-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"]
}
}
}클라이언트별 지침 및 권장 에이전트 지침은 에이전트 설정 가이드를 참조하세요.
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 = 0Sheriff는 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.jarDocker 이미지 검증:
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 참조
This server cannot be deployed
Assign Linear, Jira or GitHub issues to an AI coding agent team that plans, builds, reviews, tests.
Scores your code across 12 areas, with findings, fix prompts, and re-assessment in your AI agent
Hand tasks, bugs and finished work to AI coding agents, and get back a write-up with evidence.
Track issues, projects and dependencies with your agent in a workspace you control.
