mcp-claude-context-continuity

Name: mcp-claude-context-continuity
Availability: InStock
Author: tethiro

mcp-claude-context-continuityは、AIモデルの文脈の一貫性を保つためのPythonライブラリです。このライブラリは、自然言語処理のタスクにおいて、コンテキストを維持しながら高品質な出力を生成することを目的としています。特に、長文や複雑な対話において、その効果が発揮されます。

GitHub

GitHubスター

ユーザー評価

未評価

お気に入り

閲覧数

フォーク

イシュー

README

MCP Claude Context Continuity

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

Clone the repository:

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

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

Simple conversation:

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

Continue conversation:

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

Session Management

Save current session:

session_id = get_current_session()

Start new session:

reset_session()

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: 手動インストール

リポジトリをクローン：

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

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

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の設定ファイルに同様の設定を追加します。

使用方法

基本的な使い方

通常の会話:

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

会話の継続:

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

セッション管理

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

session_id = get_current_session()

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

reset_session()

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

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") → "太郎"と"読書"を知っている状態