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"
}
}
}
}
License
MIT