Multi-Platform Historian MCP

📜 An MCP server for conversation history search and retrieval across Claude Code, Antigravity, Windsurf, Roo Code, Codex, and vLLM.

Inspired by claude-historian-mcp, this version is adapted for users who work with multiple AI coding platforms.

Features

• Multi-platform support: Search across conversation history from Claude Code, Antigravity, Windsurf, Roo Code, Codex, and vLLM
• Two powerful tools: search and inspect
• Multiple search scopes: conversations, files, errors, plans, config, tools, similar, memories, sessions
• Zero external dependencies: Runs locally with no external databases
• Intelligent ranking: Results ranked by relevance, recency, and context
• Parallel processing: Fast search across multiple platforms

Installation

From shell

npx multi-platform-historian-mcp

MCP Configuration

Add to your MCP config (Windsurf, Cursor, etc.):

{
  "mcpServers": {
    "multi-platform-historian-mcp": {
      "command": "npx",
      "args": ["multi-platform-historian-mcp"],
      "env": {}
    }
  }
}

Platform-Specific Setup

Claude Code

Claude Code stores conversation history in ~/.claude/conversations. The MCP server will automatically detect and load from this location.

No additional setup is required - just ensure Claude Code has been used and conversations exist in the history directory.

Antigravity

Antigravity has a built-in history export tool:

pip install antigravity-history==0.2.6 --index-url https://pypi.org/simple --no-cache-dir
aghistory export

The exported conversations will be automatically detected by the MCP server.

Windsurf

Windsurf conversation history is stored locally but encrypted. To use Windsurf history:

1. Check if your Windsurf version supports history export
2. If available, export conversations to a JSON file
3. Place the export in your home directory as windsurf-export.json
4. Or specify the path in the config file

Note: Due to encryption, direct access may not be possible on all Windsurf versions.

Roo Code

Roo Code stores conversation history in the VS Code extension storage. The MCP server will automatically detect and load from:

• ~/.roocode/history
• ~/.vscode/extensions/roocode/history
• VS Code global storage directory

Codex

The Codex VS Code extension doesn't save local history by default. To use Codex history:

1. Manually export conversations if the feature is available
2. Save the export as codex-export.json in your project directory
3. Or use API logs if you have access to them

vLLM

vLLM is a library for LLM serving, not a coding assistant. To use vLLM logs:

1. Enable request logging in your vLLM configuration
2. Configure the log output path
3. Set the path in the MCP config

Note: vLLM is disabled by default in the config.

Configuration

Create a config file at ~/.multi-platform-historian/config.json or multi-platform-historian.config.json in your project:

{
  "antigravity": {
    "enabled": true,
    "historyPath": "~/.antigravity-history/export.json"
  },
  "windsurf": {
    "enabled": true,
    "historyPath": "~/.windsurf/conversations"
  },
  "roocode": {
    "enabled": true,
    "historyPath": "~/.roocode/history"
  },
  "codex": {
    "enabled": true,
    "historyPath": "~/.codex/history"
  },
  "vllm": {
    "enabled": false,
    "historyPath": "~/.vllm/logs"
  }
}

Usage

Search Tool

Search across conversations with various scopes:

search query="docker auth error"  // default scope: all
search query="fix build" scope="conversations"  // past solutions
search query="ENOENT" scope="errors"  // error patterns + fixes
search query="auth" scope="plans"  // implementation plans
search query="hooks" scope="config"  // rules, skills, config
search query="git push" scope="similar"  // related questions
search query="Edit" scope="tools"  // tool usage workflows
search filepath="package.json" scope="files"  // file change history
search scope="sessions"  // recent sessions
search scope="memories"  // project memory files
search query="deploy" scope="all" detailLevel="detailed"  // full context
search query="auth" timeframe="7d" project="my-app"  // filtered
search query="auth" platform="antigravity"  // platform-specific

Inspect Tool

Get an intelligent summary of a specific session:

inspect session_id="latest"  // most recent session
inspect session_id="d537af65"  // short prefix works
inspect session_id="d537af65" focus="files"  // only file changes
inspect session_id="d537af65" focus="tools"  // only tool usage
inspect session_id="d537af65" focus="solutions"  // only solutions
inspect session_id="d537af65" platform="windsurf"  // platform-specific

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

# Run the server
npm start

Platform Limitations

• Antigravity: Requires the antigravity-history package to export conversations
• Windsurf: History may be encrypted; export functionality may not be available on all versions
• Roo Code: Automatically detected from VS Code extension storage
• Codex: No built-in local history; requires manual export or API logs
• vLLM: Not a coding assistant; requires enabled request logging

License

MIT

Inspired By

This project is inspired by claude-historian-mcp by Vvkmnn.