How do I use DriftOS MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@DriftOS MCP Server route this message to the appropriate branch: 'Can you summarize our discussion about the project timeline?'" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

DriftOS MCP Server

MCP server for semantic conversation routing with DriftOS.

What is this?

An MCP (Model Context Protocol) server that lets any MCP-compatible client (Claude Desktop, Cursor, etc.) use DriftOS for intelligent conversation routing.

Instead of dumping entire conversation histories into LLM context, DriftOS:

Branches when new topics appear
Stays when the topic continues
Routes back when you return to a previous topic

DriftOS Backend

This MCP server requires a running DriftOS Core backend.

DriftOS Core is the semantic conversation routing engine that:

Analyzes messages to detect topic shifts and returns
Maintains a graph of conversation branches
Extracts and tracks facts across topics
Assembles relevant context for LLM calls

See the driftos-core repository for setup instructions.

Tools

Tool	Description
`driftos_route_message`	Route a message to the appropriate branch
`driftos_get_context`	Get assembled context for LLM calls
`driftos_list_branches`	List all branches in a conversation
`driftos_get_branch`	Get details about a specific branch

Setup

Prerequisites

Node.js 18+
A running DriftOS backend (default: http://localhost:3000)

Installation

npm install
npm run build

Configuration

Set the DriftOS API URL:

export DRIFTOS_API_URL=http://localhost:3000

Running

stdio mode (for Claude Desktop, etc.):

npm start

HTTP mode (for remote access):

TRANSPORT=http npm start

Claude Desktop Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "driftos": {
      "command": "node",
      "args": ["/path/to/driftos-mcp-server/dist/index.js"],
      "env": {
        "DRIFTOS_API_URL": "http://localhost:3000"
      }
    }
  }
}