Checkride MCP Server

Checkride は、AI コーディングエージェント向けの高速でローカルな「CI プリフライト」検証サイドカーとして機能する Model Context Protocol (MCP) サーバーです。

AI エージェントはコードをコミットまたはプッシュする前に、Checkride ツールを呼び出して、テストの実行、型チェック、lint の実行、セキュリティ監査、Git 安全性スキャン、AI 修正ヒントの生成、ビジュアルレポートのエクスポートを、インスタント SHA-256 キャッシュを備えたサンドボックス化されたプロセス環境で実行できます。

機能

• 高速プリフライトパイプライン: テストスイート、型チェッカー、リンターを並行して実行します。

• スマート SHA-256 キャッシュ: 変更されていないコードベースでは、10ms 未満の即時応答（[CACHED < 10ms]）を返します。

• Git & ステージングファイルインテリジェンス: 変更またはステージングされた Git ファイルのみを対象に検証と安全性チェックを実行します。

• Pre-Commit Git フック: 手動コミットの前にコードを自動検証する、ローカルの .git/hooks/pre-commit を簡単にインストールできます。

• Docker サンドボックス: プロセス実行を分離するためのオプションのコンテナ化実行（"sandbox": "docker"）。

• 依存関係のセキュリティ監査: AI エージェントが持ち込んだ脆弱性を検出するため、パッケージのセキュリティ監査（npm audit、cargo audit、pip-audit）を実行します。

• AI 修正ジェネレーター: エラーと型の不一致を分析し、プロンプトにすぐそのまま使える修正ヒントとコードスニペットを生成します。

• ビジュアルレポートエクスポーター: Markdown（.checkride/summary.md）と HTML（.checkride/report.html）の検証サマリーをエクスポートします。

• Git セーフティガードスキャナー: 残存するコンフリクトマーカー（<<<<<<<）、漏えいした API シークレット/キー、デバッグ文（console.log、debugger、breakpoint()）を検出します。

• 自動検出: パッケージマネージャー（pnpm、yarn、bun、npm）と言語（TypeScript、JavaScript、Python、Rust、Go）を自動検出します。

• 設定可能なサイドカー: .checkriderc.json を使用して、コマンド、チェックごとのタイムアウト、除外項目、カスタムビルドステップをカスタマイズできます。

公開されている MCP ツール

Git Pre-Commit フックのインストール

手動の git commit の前に Checkride チェックを自動的に実行するため、ローカルの .git/hooks/pre-commit をインストールします：

npx checkride init-hooks

設定 (.checkriderc.json)

Checkride はプロジェクトのルートディレクトリで .checkriderc.json、.checkriderc、または checkride.config.json を自動的に探します：

{
  "sandbox": "docker",
  "docker_image": "node:18-alpine",
  "timeouts": {
    "test": 60000,
    "typecheck": 60000,
    "lint": 30000,
    "security": 60000,
    "default": 60000
  },
  "commands": {
    "test": "pnpm test",
    "typecheck": "tsc --noEmit",
    "lint": "eslint .",
    "security": "npm audit --json",
    "custom": [
      {
        "name": "Format Check",
        "command": "prettier --check .",
        "timeout": 15000
      }
    ]
  },
  "exclude": ["node_modules", "dist", "build", ".git"],
  "env": {
    "CI": "true"
  }
}

AI エージェントへの接続

1. Claude Desktop の設定（claude_desktop_config.json）

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

2. Cursor / Antigravity / Claude Code の設定

{
  "mcpServers": {
    "checkride": {
      "command": "npx",
      "args": ["-y", "checkride-mcp"]
    }
  }
}

ライセンス

MIT