Checkride MCP Server

Checkride is a Model Context Protocol (MCP) server that serves as a fast, local "CI pre-flight" validation sidecar for AI coding agents.

Before an AI agent commits or pushes code, it can call Checkride tools to execute tests, type-checking, linting, security audits, Git safety scans, generate AI fix hints, and export visual reports in a sandboxed process environment with instant SHA-256 caching.

Features

• Fast Pre-Flight Pipeline: Runs test suite, type checker, and linter concurrently.

• Smart SHA-256 Caching: Instant sub-10ms responses ([CACHED < 10ms]) on unchanged codebases.

• Git & Staged-Files Intelligence: Run targeted validations and safety checks on modified or staged Git files only.

• Pre-Commit Git Hooks: Easily install local .git/hooks/pre-commit to validate code automatically before manual commits.

• Docker Sandboxing: Optional containerized execution ("sandbox": "docker") to isolate process execution.

• Dependency Security Auditing: Runs package security audits (npm audit, cargo audit, pip-audit) to detect vulnerabilities introduced by AI agents.

• AI Fix Generator: Analyzes errors and type mismatches to return prompt-ready remediation hints and code snippets.

• Visual Report Exporter: Exports Markdown (.checkride/summary.md) and HTML (.checkride/report.html) validation summaries.

• Git Safety Guard Scanner: Detects leftover conflict markers (<<<<<<<), leaked API secrets/keys, and debug statements (console.log, debugger, breakpoint()).

• Auto-Detection: Auto-detects package managers (pnpm, yarn, bun, npm) and languages (TypeScript, JavaScript, Python, Rust, Go).

• Configurable Sidecar: Customize commands, timeouts per check, excludes, and custom build steps via .checkriderc.json.

Exposed MCP Tools

Installing Git Pre-Commit Hook

Install local .git/hooks/pre-commit to automatically run Checkride checks before any manual git commit:

npx checkride init-hooks

Configuration (.checkriderc.json)

Checkride automatically looks for .checkriderc.json, .checkriderc, or checkride.config.json in the root of your project directory:

{
  "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"
  }
}

Connecting to AI Agents

1. Claude Desktop Config (claude_desktop_config.json)

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

2. Cursor / Antigravity / Claude Code Config

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

License

MIT