Skip to main content
Glama
Sign In
claude-rag-mcp

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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 recent community 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
      C
      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
      9 npm
      69
      MIT

    • Context Pilot

      applehell
      A
      license
      Not graded
      quality
      C
      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