Content
# 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)