Claude Rag

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)

Learning (4 tools)

Installation

From GitHub

npm install github:VXConsulting/claude-rag-mcp

From GitHub Packages

# 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:

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

Or if installed from GitHub:

{
  "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:

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

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

License

MIT