# claude-rag-mcp

MCP server providing RAG (Retrieval-Augmented Generation) context and failure capture for Claude Code.

## Features

- **Global Context (RAG)**: Semantic search across project knowledge
  - Architecture patterns, lessons learned, anti-patterns
  - Memory or ChromaDB persistence
  - Auto-inject relevant context

- **Failure Capture**: Store and analyze failures
  - Test failures, review rejections, quality gate violations
  - SQLite persistence
  - Retention policies

## MCP Tools (11 total)

### Context (7 tools)
| Tool | Description |
|------|-------------|
| `context_status` | Get status of the global context module |
| `context_search` | Semantic search for relevant patterns |
| `context_list` | List context entries with filtering |
| `context_get` | Get detailed entry information |
| `context_add` | Add new knowledge entry |
| `context_delete` | Delete context entries |
| `context_prune` | Remove old entries |

### Learning (4 tools)
| Tool | Description |
|------|-------------|
| `learning_status` | Get failure capture status |
| `learning_list_failures` | List captured failures |
| `learning_get_failure` | Get failure details |
| `learning_prune` | Remove old failures |

## Installation

### From GitHub
```bash
npm install github:VXConsulting/claude-rag-mcp
```

### From GitHub Packages
```bash
# Configure .npmrc first
echo "@vxconsulting:registry=https://npm.pkg.github.com" >> .npmrc

npm install @vxconsulting/claude-rag-mcp
```

## Usage with Claude Code

Add to your `.mcp.json`:

```json
{
  "mcpServers": {
    "claude-rag-mcp": {
      "command": "npx",
      "args": ["@vxconsulting/claude-rag-mcp", "serve"]
    }
  }
}
```

Or if installed from GitHub:

```json
{
  "mcpServers": {
    "claude-rag-mcp": {
      "command": "node",
      "args": ["node_modules/@vxconsulting/claude-rag-mcp/dist/cli.js", "serve"]
    }
  }
}
```

## Configuration

Create `.dev-factory.yml` in your project root:

```yaml
version: 1

globalContext:
  enabled: true
  provider: memory  # or chromadb
  autoInject:
    enabled: true
    topK: 5
    types: [architecture, lesson, anti-pattern]

learning:
  enabled: true
  failureDB:
    dbPath: .dev-factory/failures.db
    retentionDays: 30
```

## Development

```bash
npm install
npm run build
npm test
npm run serve  # Start MCP server
```

## License

MIT