Self-Host with Node.js

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

Self-Host with Node.js

Run the Xplorr MCP server locally or on your own server using Node.js.

Prerequisites

• Node.js 20+
• An Xplorr API token

Setup

1. Clone and install

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

2. Configure

   cp .env.example .env

   Edit .env and set your API token:

   XPLORR_API_TOKEN=xplorr_your_token_here

3. Start the server

   npm start
   # Server running on http://localhost:3005

   Verify it’s healthy:

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

4. 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.

Development mode

Run with auto-reload during development:

npm run dev

Environment variables

See the Configuration reference →

Pointing at a self-hosted backend

If you run the full Xplorr platform on-premises, override the API URL:

XPLORR_API_TOKEN=xplorr_your_token_here
XPLORR_API_URL=https://api.your-company.com