commit-check MCP server

commit-check-mcp

Model Context Protocol (MCP) server for commit-check.

commit-check-mcp exposes commit-check as local MCP tools so an MCP client can validate commit messages, branch names, author info, push safety, and repository state.

Features

This MCP server exposes commit-check validations as MCP tools:

• server_health — returns server/sdk versions
• validatecommitmessage — validates a commit message
• validatebranchname — validates a branch name or the current repo branch
• validatepushsafety — validates that a push is not a force push (force pushes are always rejected by this tool)
• validateauthorinfo — validates author name/email or the repo's git author config
• validatecommitcontext — runs combined checks in one call
• validaterepositorystate — validates latest commit, current branch, author state, and optional push safety for a repo
• describevalidationrules — returns the effective config and enabled rules after merging defaults and repo config

All validation tools return the same structured commit-check result shape:

{
  "status": "pass|fail|skip",
  "warnings": 0,
  "checks": [
    {
      "rule_id": "CC001",
      "check": "message",
      "status": "pass|fail|warn|skip",
      "value": "...",
      "error": "...",
      "suggest": "...",
      "fix": "...",
      "docs_url": "https://commit-check.com/rules/#cc001"
    }
  ]
}

ruleid is the stable id of the rule that produced the check and docsurl links to its documentation.

Only fail is a rejection. A check reports skip when it did not run — the author matched ignoreauthors, or there was nothing to check — and the top-level status is skip only when every** check skipped, so a run that validated nothing is never reported as a pass. A check reports warn when the config lists it under warn: the finding is complete, but it does not fail the run, the top-level status stays pass, and warnings counts them.

suggest is the advice a person reads. fix is the corrected value itself, present only when the correction is unambiguous — Fix: add x comes back with "fix": "fix: add x" — and an empty string otherwise, so an agent can apply a non-empty fix as it stands and fall back to suggest when it is empty.

Shortened. The full README is on GitHub.