Skip to main content
Glama
tethiro

MCP Claude Context Continuity

by tethiro
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

MCP Claude Context Continuity

npm version License: MIT

An MCP (Model Context Protocol) server that maintains conversation context for Claude CLI across multiple invocations.

Features

  • 🔄 Conversation Continuity: Leverages Claude CLI's --resume feature to maintain conversation context across multiple calls

  • 📝 Session Management: Save, restore, and branch conversations

  • 🖥️ Cross-platform: Supports Windows (via WSL), Linux, and macOS

  • ⚡ Simple Implementation: All functionality in a single Python file

Requirements

  • Python 3.8+

  • Claude CLI (must be installed in WSL for all platforms)

  • FastMCP (pip install fastmcp)

  • WSL2 for Windows environments

  • Windows: Python must be installed on Windows (not in WSL)

Installation

Option 1: Using npm (Recommended)

npm install -g mcp-claude-context-continuity

After installation, the server will be available as a global command.

Option 2: Manual Installation

  1. Clone the repository:

git clone https://github.com/tethiro/mcp-claude-context-continuity.git cd mcp-claude-context-continuity

  1. Install dependencies:

pip install -r requirements.txt

Configuration

Gemini CLI (Recommended)

Add the following to your Gemini configuration file:

Using npm global install (Simplest)

All platforms (~/.gemini/settings.json or %USERPROFILE%\.gemini\settings.json):

{ "mcpServers": { "claude-cli-server": { "command": "mcp-claude-context-continuity" } } }

Manual installation

Windows (%USERPROFILE%\.gemini\settings.json):

{ "mcpServers": { "claude-cli-server": { "command": "wsl", "args": [ "-e", "python3", "/mnt/c/path/to/mcp-claude-context-continuity/src/claude_cli_server.py" ] } } }

WSL/Linux/macOS (~/.gemini/settings.json):

{ "mcpServers": { "claude-cli-server": { "command": "python3", "args": [ "/path/to/mcp-claude-context-continuity/src/claude_cli_server.py" ] } } }

Claude Desktop

Add similar configuration to your Claude Desktop settings file.

Usage

Basic Usage

  1. Simple conversation:

execute_claude(prompt="Hello, I'm John")

  1. Continue conversation:

execute_claude(prompt="Do you remember my name?") → "Yes, you're John"

Session Management

  1. Save current session:

session_id = get_current_session()

  1. Start new session:

reset_session()

  1. Restore saved session:

set_current_session(session_id="saved_id")

Available Tools

Tool

Description

execute_claude

Execute Claude CLI with conversation continuity

execute_claude_with_context

Execute with file context

get_execution_history

Get execution history

get_current_session

Get current session ID

set_current_session

Set session ID

reset_session

Reset session

clear_execution_history

Clear history

test_claude_cli

Test functionality

How Session Management Works

Using Claude CLI's --resume feature, you can return to any point in a conversation using session IDs:

Conversation 1: "I'm Alice" → session_id: AAA Conversation 2: "I like reading" (--resume AAA) → session_id: BBB Conversation 3: "My favorite book is..." (--resume BBB) → session_id: CCC Later: set_current_session("AAA") → State where only "Alice" is known set_current_session("BBB") → State where "Alice" and "reading" are known

Troubleshooting

Claude CLI Not Found

Set the CLAUDE_PATH environment variable:

export CLAUDE_PATH=/path/to/claude

Windows Environment Notes

  • WSL2 is required

  • Install Claude CLI inside WSL

  • Use WSL format paths (/mnt/c/...)

License

MIT License

MCP Claude Context Continuity

Claude CLIの会話コンテキストを保持するMCP（Model Context Protocol）サーバーです。

特徴

  • 🔄 会話の継続性: Claude CLIの--resume機能を活用し、複数の呼び出し間で会話コンテキストを保持

  • 📝 セッション管理: 会話の保存、復元、分岐が可能

  • 🖥️ クロスプラットフォーム: Windows（WSL経由）、Linux、macOS対応

  • ⚡ シンプルな実装: 単一のPythonファイルで全機能を提供

必要条件

  • Python 3.8以上

  • Claude CLI（WSL内にインストール必須）

  • FastMCP（pip install fastmcp）

  • Windows環境の場合はWSL2

  • Windows: PythonはWindows側にインストール（WSL内ではなく）

インストール

方法1: npmを使用（推奨）

npm install -g mcp-claude-context-continuity

インストール後、グローバルコマンドとして利用可能になります。

方法2: 手動インストール

  1. リポジトリをクローン：

git clone https://github.com/tethiro/mcp-claude-context-continuity.git cd mcp-claude-context-continuity

  1. 依存関係をインストール：

pip install -r requirements.txt

設定

Gemini CLI（推奨）

Geminiの設定ファイルに以下を追加：

npmグローバルインストールを使用（最も簡単）

全環境共通 (~/.gemini/settings.json または %USERPROFILE%\.gemini\settings.json):

{ "mcpServers": { "claude-cli-server": { "command": "mcp-claude-context-continuity" } } }

手動インストールの場合

Windows環境 (%USERPROFILE%\.gemini\settings.json):

{ "mcpServers": { "claude-cli-server": { "command": "wsl", "args": [ "-e", "python3", "/mnt/c/path/to/mcp-claude-context-continuity/src/claude_cli_server.py" ] } } }

WSL/Linux/macOS (~/.gemini/settings.json):

{ "mcpServers": { "claude-cli-server": { "command": "python3", "args": [ "/path/to/mcp-claude-context-continuity/src/claude_cli_server.py" ] } } }

Claude Desktop

Claude Desktopの設定ファイルに同様の設定を追加します。

使用方法

基本的な使い方

  1. 通常の会話:

execute_claude(prompt="こんにちは、私は山田です")

  1. 会話の継続:

execute_claude(prompt="私の名前を覚えていますか？") → "はい、山田さんですね"

セッション管理

  1. 現在のセッションを保存:

session_id = get_current_session()

  1. 新しいセッションを開始:

reset_session()

  1. 保存したセッションに戻る:

set_current_session(session_id="保存したID")

利用可能なツール

ツール

説明

execute_claude

Claude CLIを実行（会話継続）

execute_claude_with_context

ファイルコンテキスト付きで実行

get_execution_history

実行履歴を取得

get_current_session

現在のセッションIDを取得

set_current_session

セッションIDを設定

reset_session

セッションをリセット

clear_execution_history

履歴をクリア

test_claude_cli

動作確認

セッション管理の仕組み

Claude CLIの--resume機能を活用し、セッションIDによって会話の任意の時点に戻ることができます：

会話1「私は太郎です」 → session_id: AAA 会話2「趣味は読書です」（--resume AAA） → session_id: BBB 会話3「好きな本は...」（--resume BBB） → session_id: CCC 後から： set_current_session("AAA") → "太郎"のみ知っている状態 set_current_session("BBB") → "太郎"と"読書"を知っている状態

トラブルシューティング

Claude CLIが見つからない場合

環境変数CLAUDE_PATHを設定：

export CLAUDE_PATH=/path/to/claude

Windows環境での注意点

  • WSL2が必要です

  • Claude CLIはWSL内にインストールしてください

  • ファイルパスはWSL形式（/mnt/c/...）で指定

ライセンス

MIT License

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tethiro/mcp-claude-context-continuity'

If you have feedback or need assistance with the MCP directory API, please join our Discord server