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

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