Skip to main content
Glama
VXConsulting

claude-rag-mcp

by VXConsulting
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

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

Related MCP server: ClaudeHistoryMCP

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-context

    ericlimabr
    F
    license
    Not graded
    quality
    D
    maintenance
    Local MCP server that provides semantic search (RAG) over code repositories, enabling AI clients like Claude and Gemini to access project context without manual re-upload.
    -

  • ClaudeHistoryMCP

    jhammant
    A
    license
    A
    quality
    D
    maintenance
    An MCP server that makes Claude Code conversation history searchable and proactively useful by indexing past sessions with hybrid BM25+TF-IDF search, extracting decisions and solutions, and auto-injecting relevant project context at session start.
    9
    6 npm
    66
    MIT

  • Context Pilot

    applehell
    A
    license
    Not graded
    quality
    A
    maintenance
    MCP server providing persistent, searchable memory management for AI workflows, enabling Claude Code to store, retrieve, and organize context through CRUD operations and knowledge tools.
    MIT