# GauntletCI MCP Server

Model Context Protocol (MCP) server that exposes GauntletCI behavioral change risk analysis
as tools for AI coding assistants (Claude, Copilot, Cursor, etc.).

## Tools

| Tool | Description |
|------|-------------|
| `analyze_commit` | Run GauntletCI on HEAD, return findings as readable text |
| `get_findings_json` | Run GauntletCI, return raw JSON for programmatic use |
| `get_sarif` | Run GauntletCI, return SARIF 2.1.0 report |

## Requirements

- Node.js 20+
- GauntletCI CLI: `dotnet tool install -g GauntletCI`

## Installation

```bash
npm install
npm run build
```

## Usage with Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "gauntletci": {
      "command": "node",
      "args": ["/path/to/GauntletCI-MCP/dist/index.js"]
    }
  }
}
```

## Usage with VS Code (Copilot)

Add to `.vscode/mcp.json`:

```json
{
  "servers": {
    "gauntletci": {
      "type": "stdio",
      "command": "node",
      "args": ["${workspaceFolder}/path/to/GauntletCI-MCP/dist/index.js"]
    }
  }
}
```

## Example prompts

Once connected, ask your AI assistant:

- "Run GauntletCI on this repo at /home/user/myapp and summarize the findings."
- "Are there any block-level risks in the current commit?"
- "Get the SARIF report for this commit."

## Links

- [MCP specification](https://modelcontextprotocol.io)
- [GauntletCI documentation](https://gauntletci.com/docs)
- [GauntletCI engine](https://github.com/EricCogen/GauntletCI)