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

Container/IaC

trivy --format sarif

SonarQube

マルチ言語

組み込みの 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 は、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 を参照してください。

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.
    55 npm
    MIT
  • F
    license
    Not graded
    quality
    D
    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
    C
    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
    60 PyPI
    4
    MIT