Self-Host with Docker

import { Steps } from ‘@astrojs/starlight/components’;

Self-Host with Docker

Run the Xplorr MCP server as a Docker container. Pre-built images are published to the GitHub Container Registry.

Quick start (one command)

docker run -d \
  --name xplorr-mcp \
  -e XPLORR_API_TOKEN=xplorr_your_token_here \
  -p 3005:3005 \
  --restart unless-stopped \
  ghcr.io/xplorrio/xplorr-mcp-server:latest

Verify it’s running:

curl http://localhost:3005/health
# {"status":"ok","service":"xplorr-mcp","tools":21,"mode":"single-tenant"}

Then connect Claude Desktop below.

Docker Compose

1. Clone the repo

   git clone https://github.com/Xplorrio/xplorr-mcp-server.git
   cd xplorr-mcp-server

2. Configure

   cp .env.example .env
   # Edit .env and set XPLORR_API_TOKEN=xplorr_your_token_here

3. Start

   docker compose up -d

4. View logs

   docker compose logs -f

5. Stop

   docker compose down

Connect Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "xplorr": {
      "url": "http://localhost:3005/mcp"
    }
  }
}

Restart Claude Desktop.

Image tags

Images are published to GitHub Container Registry:

Tag	Description
latest	Most recent build from main
v1.2.3	Specific release
v1.2	Latest patch for minor version
v1	Latest minor/patch for major version

Pin to a specific version in production:

docker run ghcr.io/xplorrio/xplorr-mcp-server:v1.0.0 ...

Environment variables

See the Configuration reference →