# commit-check MCP server

> Validates commit messages, branch names, and author information against team policies to ensure compliance before pushing code.

- Repository: https://github.com/commit-check/commit-check-mcp
- Page: https://hostedmcp.org/servers/commit-check/commit-check-mcp
- Transport: stdio
- Stars: 1
- License: MIT
- Latest version: 0.1.13

## Install

### Claude Code

```sh
claude mcp add commit-check-mcp -- uvx commit-check-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "commit-check-mcp": {
      "command": "uvx",
      "args": [
        "commit-check-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "commit-check-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "commit-check-mcp"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "commit-check-mcp": {
      "command": "uvx",
      "args": [
        "commit-check-mcp"
      ]
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.commit-check-mcp]
command = "uvx"
args = ["commit-check-mcp"]
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "commit-check-mcp": {
      "command": "uvx",
      "args": [
        "commit-check-mcp"
      ]
    }
  }
}
```

## Tools (11)

- `validate_commit_message`
- `validate_branch_name`
- `validate_author_info`
- `validate_commit_context`
- `validate_push_safety`
- `validate_repository_state`
- `describe_validation_rules`
- `server_health`
- `repo_path`
- `config_path`
- `config`

## FAQ

### What does this server validate?

It validates commit messages, branch names, author information, and push safety (such as preventing force pushes).

### Does the server change my code or commits?

No, the tools are read-only and do not modify the working tree or commits.

### How can an AI agent fix a failed validation?

When a validation fails, the server provides a 'fix' that the agent can apply verbatim to resolve the issue.