commit-check MCP

マージ前に、不適切なコミットを AI エージェント内で検出します。

ドキュメント · ルール · CLI · GitHub Action · GitHub App

Commit Check の Model Context Protocol サーバーです。チームや AI エージェント向けに、コミットポリシーをコードとして管理します。CI が適用するルールをコーディングエージェントに提供します。エージェントはコミットやプッシュの前に、コミットメッセージ、ブランチ名、作成者を検証します。修正方法が明確な場合は、適用すべき修正も提示します。

クイックスタート

claude mcp add commit-check -- uvx commit-check-mcp

ほかのすべてのクライアントでも同じコマンドを起動します。登録するオブジェクトは次のとおりです。

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

まだ uv をインストールしていませんか？curl -LsSf https://astral.sh/uv/install.sh | sh を実行するか、下の最後の行にあるように pip install commit-check-mcp を使用してください。

各クライアントでの設定場所

Continue の config.yaml エントリー全体です（name、version、schema は Continue で必須です。既存ファイルに mcpServers フラグメントのみを追加する場合はこれらを削除するか、.continue/mcpServers/ 内の単独ファイルとして保存してください）。

name: commit-check
version: 0.0.1
schema: v1
mcpServers:
  - name: commit-check
    command: uvx
    args: ["commit-check-mcp"]

ツール

server_health を除くすべてのツールは、次の引数も受け取ります。

• repo_path — cchk.toml / commit-check.toml が適用されるリポジトリです。 ツールが git の状態を読み取る場合は git リポジトリである必要があります。すべての値を自分で渡す場合は、設定ファイルを含む通常のディレクトリで十分です。
• config_path — リポジトリ独自の設定の代わりに使用する設定ファイルです。 相対パスは repo_path を起点に解決されます。
• config — インラインのオーバーライドです。上位の設定に統合されます。例：{"commit": {"require_body": true}}。

どのツールも作業ツリーやコミットを変更しません。validate_push_safety と validate_repository_state は SHA を解決するために git fetch を実行する場合があるため、読み取り専用ではないと注釈されているのはこの 2 つだけです。MCP ツールのヒントに基づいて許可を制御するクライアントは、残り 6 つを自動承認できます。

{
  "message": "feat(api): add MCP validation tool",
  "repo_path": "/path/to/repo"
}

{
  "repo_path": "/path/to/repo",
  "include_push": true
}

{
  "repo_path": "/path/to/repo",
  "push_refs": "refs/heads/main abc123 refs/heads/main def456"
}

{
  "repo_path": "/path/to/repo",
  "config": {
    "commit": {
      "require_body": true
    }
  }
}

結果

すべての validate_* ツールは、commit-check --format json が出力する形式を返します。

{
  "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",
      "reason": ""
    }
  ]
}

• 拒否となるのは fail だけです。skip は何も検証されなかったことを意味し、承認として扱ってはいけません。warn は実行を失敗させずに報告されます。commit-check 2.19.0 以降では、スキップされたチェックの理由が reason に示されます。例："author dependabot[bot] is in [commit].ignore_authors"。それより古いリリースでは、このフィールドは出力されません。
• fail の場合、空でない fix があればその内容をそのまま適用し、そうでなければ suggest に従ってから、もう一度検証してください。サーバーの指示により、エージェントはこの手順を実行します。
• 呼び出し自体を実行できない場合（空の message、存在しない repo_path、必要な場面で git リポジトリではない repo_path、無効な設定、解決できない push_refs の SHA など）は、問題を示す MCP ツールエラーが返されます。合格として返されることはありません。

開発

pip install -e .[dev]
python -m pytest

サーバーは stdio で通信するため、MCP クライアントが起動します。起動を確認する場合に限り、手動で uvx commit-check-mcp を実行してください。

コミュニティ

質問やアイデアはディスカッションへ、バグはイシューへお寄せください。 リリースにはセマンティック バージョニングを採用しています。MIT ライセンスの下でリリースされています。

_{mcp-name: io.github.commit-check/commit-check-mcp}