Quick Start

This guide will help you get MCP Director up and running quickly.

Basic Usage

Starting the Server

mcp-director serve --config config/default.yaml

Global options: --json (machine-readable output), --dry-run (preview changes), and --yes (auto-confirm removals).

Client Configuration

Single Client Mode

For a single AI client, use serve directly.

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "director": {
      "command": "mcp-director",
      "args": ["serve"]
    }
  }
}

Multi-Client Mode

For multiple AI clients sharing the same MCP Director instance:

Step 1: Start the daemon:

mcp-director serve --no-stdio

Step 2: Configure clients to use connect:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "director": {
      "command": "mcp-director",
      "args": ["connect", "--project", "my-project"]
    }
  }
}

Claude Code (.mcp.json):

{
  "mcpServers": {
    "director": {
      "command": "mcp-director",
      "args": ["connect", "--project", "my-project"]
    }
  }
}

HTTP Mode (Cursor, etc.)

1. Go to MCP settings in Cursor
2. Add a new server:
   • URL: http://localhost:3000/sse
   • Transport: SSE
   • Optional: append ?project=your-project&profile=your-profile

Architecture Overview

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Claude Desktop │     │   Claude Code   │     │     Cursor      │
└────────┬────────┘     └────────┬────────┘     └────────┬────────┘
         │                       │                       │
         │ STDIO                 │ STDIO                 │ HTTP/SSE
         │                       │                       │
         └───────────────────────┴───────────────────────┘
                                 │
                    ┌────────────▼────────────┐
                    │      MCP Director       │
                    │  ┌───────────────────┐  │
                    │  │  Router + ACL     │  │
                    │  │  Profiles/Projects│  │
                    │  │  Analytics        │  │
                    │  └───────────────────┘  │
                    └────────────┬────────────┘
                                 │
         ┌───────────────────────┼───────────────────────┐
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  MCP Server 1   │     │  MCP Server 2   │     │  MCP Server N   │
│   (filesystem)  │     │    (github)     │     │     (custom)    │
└─────────────────┘     └─────────────────┘     └─────────────────┘

Next Steps

• Configuration Reference - Learn about all configuration options
• CLI Reference - Full command-line reference