Cortex RMCP MCP Server

Name: Cortex RMCP MCP Server
Author: ai.dinglebear

ai.dinglebear/cortex-rmcp

Repository Registry

What is the Cortex RMCP MCP server?

Rust MCP server for homelab logs, syslog, Docker logs, FTS search, and AI transcript correlation.

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.

Claude Desktop

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

{
  "mcpServers": {
    "cortex-rmcp": {
      "command": "npx",
      "args": [
        "-y",
        "cortex-rmcp",
        "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>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "cortex-rmcp": {
      "command": "npx",
      "args": [
        "-y",
        "cortex-rmcp",
        "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>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cortex-rmcp": {
      "command": "npx",
      "args": [
        "-y",
        "cortex-rmcp",
        "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>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "cortex-rmcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cortex-rmcp",
        "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>"
      }
    }
  }
}

Claude Code

claude mcp add cortex-rmcp --env CORTEX_HOME=<YOUR_CORTEX_HOME> --env CORTEX_TOKEN=<YOUR_CORTEX_TOKEN> --env CORTEX_API_TOKEN=<YOUR_CORTEX_API_TOKEN> --env CORTEX_RMCP_VERSION=<YOUR_CORTEX_RMCP_VERSION> --env CORTEX_RMCP_REPO=<YOUR_CORTEX_RMCP_REPO> --env CORTEX_RMCP_RELEASE_BASE_URL=<YOUR_CORTEX_RMCP_RELEASE_BASE_URL> --env RUST_LOG=<YOUR_RUST_LOG> -- npx -y cortex-rmcp mcp