Claude

You can run an MCP server that preserves Claude CLI conversation context across multiple invocations. This lets you continue conversations, save and restore sessions, and branch conversations seamlessly from any client that supports MCP.

How to use

Install and run the MCP server, then connect your MCP client to the server to manage Claude-based conversations. You can start a simple chat, resume conversations later using a session, and switch between different conversation states as needed. Use the provided tools to execute Claude with continuity, manage sessions, and review your execution history.

How to install

# Prerequisites
# - Python 3.8+
# - Claude CLI installed (in WSL for all platforms)
# - FastMCP
# - NPM (for npm-based installation)

# Option 1: Using npm (recommended)
npm install -g mcp-claude-context-continuity

# Option 2: Manual installation
# 1) Clone the repository
# git clone https://github.com/tethiro/mcp-claude-context-continuity.git
# cd mcp-claude-context-continuity

# 2) Install dependencies
pip install -r requirements.txt

Configuration and usage notes

Two standard ways to configure the MCP client side are shown below. Choose the one that matches your environment. The first option uses a global MCP server command installed via npm. The second option runs a Python server script through your preferred environment.

{
  "mcpServers": {
    "claude-cli-server": {
      "command": "mcp-claude-context-continuity",
      "args": []
    }
  }
}

Troubleshooting and notes

If Claude CLI isn’t found, set the CLAUDE_PATH environment variable to the location of your Claude CLI binary. In a shell, you can export it like this.

export CLAUDE_PATH=/path/to/claude

Additional setup for different platforms

Windows users can run the server via WSL2. Claude CLI must be installed inside WSL, and you should reference WSL-style paths in your configuration.

Unix-like systems (Linux/macOS) use the Python server script directly. If you switch between environments, use the corresponding command and path shown in the installation steps.

Security and environment considerations

Keep your Claude CLI readily accessible to the MCP server through the CLAUDE_PATH variable. Do not expose server endpoints publicly unless you protect them with proper authentication and network controls.

Tools and capabilities

The MCP server exposes a set of tools for interacting with Claude with context continuity. You can execute Claude with conversation continuity, manage sessions, and retrieve execution history.

Available tools

execute_claude

Execute Claude CLI with conversation continuity by sending prompts and receiving responses that preserve context across calls.

execute_claude_with_context

Execute Claude with file context to influence responses based on provided files.

get_execution_history

Retrieve the history of executed prompts and responses for auditing or review.

get_current_session

Return the identifier of the currently active conversation session.

set_current_session

Set the active session by providing a specific session ID to resume work from that point.

reset_session

Start a new, isolated conversation session, discarding the previous context.

clear_execution_history

Clear the stored history of prompts and responses.

test_claude_cli

Run a quick test to verify Claude CLI integration and context continuity.