Cortex Local Rag MCP Server

by vblackjackio.github.VBlackJack/cortexv2026.909.4

Local multi-client RAG server over the Model Context Protocol.

1Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active30d ago

Install Cortex Local Rag MCP server

claude mcp add cortex-local-rag -e CORTEX_KB_PATH='<cortex-kb-path>' -- uvx cortex-local-rag serve

{
  "mcpServers": {
    "cortex-local-rag": {
      "command": "uvx",
      "args": [
        "cortex-local-rag",
        "serve"
      ],
      "env": {
        "CORTEX_KB_PATH": "<cortex-kb-path>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "cortex-local-rag": {
      "command": "uvx",
      "args": [
        "cortex-local-rag",
        "serve"
      ],
      "env": {
        "CORTEX_KB_PATH": "<cortex-kb-path>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "cortex-local-rag": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "cortex-local-rag",
        "serve"
      ],
      "env": {
        "CORTEX_KB_PATH": "<cortex-kb-path>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "cortex-local-rag": {
      "command": "uvx",
      "args": [
        "cortex-local-rag",
        "serve"
      ],
      "env": {
        "CORTEX_KB_PATH": "<cortex-kb-path>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
CORTEX_KB_PATH	yes	—	Absolute path to the local knowledge base Cortex indexes and serves.

Freshness

Active — last maintenance signal 30d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-09 · 30d ago · GitHub
Latest release
2026-09-09 · 30d ago · GitHub · v2026.0909.04
Package published
no data · npm/PyPI
Registry entry updated
2026-09-09 · 30d ago · official registry · v2026.909.4

FAQ

›How do I install the Cortex Local Rag MCP server in Claude Code?

Run: claude mcp add cortex-local-rag -e CORTEX_KB_PATH='<cortex-kb-path>' -- uvx cortex-local-rag serve. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Cortex Local Rag require an API key?

Yes. It expects CORTEX_KB_PATH.

›Can I use Cortex Local Rag as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Cortex Local Rag in the official MCP registry?

Yes, as io.github.VBlackJack/cortex.