Cortex RMCP MCP Server

ai.dinglebear/cortex

Repository Registry

What is the Cortex RMCP MCP server?

Self-hosted homelab log intelligence over MCP, CLI, and REST with SQLite/FTS.

How to install Cortex RMCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

CORTEX_HOME
Optional Cortex home directory containing configuration and local SQLite data.
CORTEX_TOKEN
secret
Optional bearer token for Cortex MCP HTTP mode; also used by some shared configs.
CORTEX_API_TOKEN
secret
Bearer token for Cortex REST API routes when running daemon/API mode.
CORTEX_RMCP_VERSION
Optional GitHub release tag override for the downloaded Cortex binary.
CORTEX_RMCP_REPO
Optional GitHub owner/repo override for release asset downloads.
CORTEX_RMCP_RELEASE_BASE_URL
Optional release download base URL override.
RUST_LOG
Tracing filter for Cortex logs.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "cortex": {
      "command": "npx",
      "args": [
        "-y",
        "@dinglebear/cortex",
        "mcp"
      ],
      "env": {
        "CORTEX_HOME": "<YOUR_CORTEX_HOME>",
        "CORTEX_TOKEN": "<YOUR_CORTEX_TOKEN>",
        "CORTEX_API_TOKEN": "<YOUR_CORTEX_API_TOKEN>",
        "CORTEX_RMCP_VERSION": "<YOUR_CORTEX_RMCP_VERSION>",
        "CORTEX_RMCP_REPO": "<YOUR_CORTEX_RMCP_REPO>",
        "CORTEX_RMCP_RELEASE_BASE_URL": "<YOUR_CORTEX_RMCP_RELEASE_BASE_URL>",
        "RUST_LOG": "<YOUR_RUST_LOG>"
      }
    }
  }
}