What is the Cortex MCP server?
Syslog receiver and MCP server for homelab log intelligence.
How to install Cortex
Copy-paste configuration for popular MCP clients.
transport: stdio
Config generated by PluginBench — verify against the source before use.Environment / auth
CORTEX_RECEIVER_HOSTrequiredHostname or IP of the syslog listener.
CORTEX_TOKENsecretBearer token for MCP endpoint authentication.
CORTEX_RECEIVER_PORTSyslog listener port (UDP + TCP). Default: 1514.
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"cortex": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/jmagar/cortex:1.32.2"
],
"env": {
"CORTEX_RECEIVER_HOST": "<YOUR_CORTEX_RECEIVER_HOST>",
"CORTEX_TOKEN": "<YOUR_CORTEX_TOKEN>",
"CORTEX_RECEIVER_PORT": "<YOUR_CORTEX_RECEIVER_PORT>"
}
}
}
}Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cortex": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/jmagar/cortex:1.32.2"
],
"env": {
"CORTEX_RECEIVER_HOST": "<YOUR_CORTEX_RECEIVER_HOST>",
"CORTEX_TOKEN": "<YOUR_CORTEX_TOKEN>",
"CORTEX_RECEIVER_PORT": "<YOUR_CORTEX_RECEIVER_PORT>"
}
}
}
}Windsurf
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"cortex": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/jmagar/cortex:1.32.2"
],
"env": {
"CORTEX_RECEIVER_HOST": "<YOUR_CORTEX_RECEIVER_HOST>",
"CORTEX_TOKEN": "<YOUR_CORTEX_TOKEN>",
"CORTEX_RECEIVER_PORT": "<YOUR_CORTEX_RECEIVER_PORT>"
}
}
}
}VS Code
.vscode/mcp.json
{
"servers": {
"cortex": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/jmagar/cortex:1.32.2"
],
"env": {
"CORTEX_RECEIVER_HOST": "<YOUR_CORTEX_RECEIVER_HOST>",
"CORTEX_TOKEN": "<YOUR_CORTEX_TOKEN>",
"CORTEX_RECEIVER_PORT": "<YOUR_CORTEX_RECEIVER_PORT>"
}
}
}
}Claude Code
claude mcp add cortex --env CORTEX_RECEIVER_HOST=<YOUR_CORTEX_RECEIVER_HOST> --env CORTEX_TOKEN=<YOUR_CORTEX_TOKEN> --env CORTEX_RECEIVER_PORT=<YOUR_CORTEX_RECEIVER_PORT> -- docker run -i --rm ghcr.io/jmagar/cortex:1.32.2Related MCP servers
MCP server for self-hosted Gotify push notifications and message management.
View repository →MCP server for Unraid API — provides tools to interact with an Unraid server's GraphQL API.
View repository →