Добавить сервер
conversation-handoff-mcp
  1. Каталог MCP
  2. conversation-handoff-mcp

conversation-handoff-mcp

от trust-delta
MCP-сервер для передачи контекста между AI-чатами и проектами. Сохраняет, загружает и объединяет handoff-диалоги с тегами и поиском. Для бесшовного продолжения работы. Поддерживает авто-подключение.
GithubNPMСайт сервера

conversation-handoff-mcp

npm version License: MIT CI MCP Apps

MCP server for transferring conversation context between AI chats or different projects within the same AI.

日本語ドキュメント

Features

  • Prompt Injection Protection (v0.14.0+): handoff_load returns stored content inside untrusted-content markers — a warning banner, a one-time boundary token that content cannot forge, and code fences widened past any backtick run in the body
  • Sender Metadata (v0.14.0+): Optional from_project / spawner_dispatch_id / sender_agent_id let an orchestrator record who sent a handoff, without tying the server to any one ecosystem
  • Tags & Search (v0.12.0+): Tag handoffs with structured labels (project:foo, issue:176) and discover them with handoff_search — multi-criteria filtering by tags, text, project, AI, status, and date range
  • Handoff Metadata (v0.11.0+): Enrich handoff_list with message count, size, status, and next action — decide on work resumption without loading full conversations
  • Comments/Annotations (v0.10.0+): Add notes and annotations to handoffs for cross-session context
  • Server Restart (v0.9.0+): Restart the shared HTTP server from any MCP client — useful after package updates
  • Audit Logging (v0.7.0+): Optional structured JSONL logging for diagnostics (--audit flag)
  • Verbatim Conversation Saving (v0.6.1+): AI saves complete conversations without summarization or abbreviation
  • Merge Handoffs (v0.6.0+): Combine multiple related handoffs into one unified context
  • MCP Apps UI (v0.5.0+): Interactive UI for browsing and managing handoffs on compatible clients
  • Auto-Connect (v0.4.0+): Server automatically starts in the background - no manual setup required
  • Auto-Reconnection (v0.4.0+): Seamlessly reconnects when server goes down - no manual intervention needed
  • Memory-Based Storage: Lightweight temporary clipboard design - no files written to disk
  • Common Format: Human-readable Markdown format
  • Lightweight API: Returns only summaries when listing to save context
  • Auto-Generated Keys (v0.4.0+): Key and title are now optional in handoff_save
Инструменты были проиндексированы:
handoff_add_comment

Добавляет комментарий или аннотацию к существующей передаче. Комментарии включаются при загрузке передачи.

Параметры
  • authorstring

    Имя автора комментария (по умолчанию: 'anonymous')

  • contentstringобязательный

    Содержимое комментария

  • keystringобязательный

    Ключевой момент передачи, который нужно прокомментировать.

handoff_append

Добавляет фрагмент разговора к существующему handoff. Используйте, чтобы загрузить длинные разговоры частями. ## Когда использовать - Полный разговор весит больше ~100 КБ. - handoff_save падает с ошибкой разбора XML или ошибкой входных данных на длинном разговоре. Claude Code кодирует аргументы вызовов инструментов как XML внутри себя — очень длинные строки conversation могут сломать это кодирование (например, когда полезная нагрузка содержит подстроки, похожие на теги). Разбивка загрузки на мелкие части предотвращает такой сбой. ## Как использовать 1. Сначала вызовите handoff_save с начальной частью (и всеми метаданными: title, summary и т.д.), чтобы создать handoff. 2. Вызывайте handoff_append по очереди со следующими фрагментами, пока не загрузите весь разговор. 3. Фрагменты объединяются как есть — включайте любые переводы строк или разделители внутрь каждого фрагмента. Общий размер разговора не должен превышать лимит хранилища (по умолчанию 1 МиБ).

Параметры
  • chunkstringобязательный

    Текст диалога для добавления. Присоединяется к существующему диалогу как есть: включайте начальные переносы строк, если нужно.

  • keystringобязательный

    Ключ handoff, к которому добавляются данные (создан через handoff_save).

handoff_clear

Очистить хендоффы. Если указан ключ, очищается только этот хендофф. В противном случае очищаются все.

Параметры
  • keystring

    Необязательно: конкретный ключ передачи для очистки.

handoff_delete_comment

Удалить комментарий из handoff по его ID комментария.

Параметры
  • comment_idstringобязательный

    ID комментария, который нужно удалить

  • keystringобязательный

    Ключ передачи.

handoff_list

Выводит список всех сохраненных переключений с кратким описанием. Возвращает облегченные метаданные без полного содержимого диалога. Открывает интерактивный интерфейс, если поддерживается.

Список передачи

Параметры

Без параметров.

handoff_load

Загружает конкретную передачу по ключу. Возвращает полное содержимое разговора.

Параметры
  • keystringобязательный

    Ключ передачи для загрузки

  • max_messagesnumber

    Необязательно: ограничьте количество возвращаемых сообщений.

handoff_merge

Объединяет несколько передач в одну. Сводит разговоры и метаданные из связанных передач в единую унифицированную передачу.

Параметры
  • delete_sourcesboolean

    Удалять ли исходные handoffs после слияния

  • keysstring[]обязательный

    Ключи handoffs для объединения (минимум 2)

  • new_keystring

    Ключ для объединённой передачи. Генерируется автоматически, если не указан.

  • new_summarystring

    Сводка для объединённой передачи. Автоматически создаётся из исходных сводок, если не указана.

  • new_titlestring

    Заголовок для объединённого handoff. Автоматически генерируется, если не указан.

  • strategyenum

    Стратегия слияния: 'chronological' сортирует по времени создания, 'sequential' сохраняет порядок массива.

handoff_restart

Перезапустите общий HTTP-сервер. Полезно, когда сервер находится в нездоровом состоянии. Все сохранённые передачи будут потеряны (данные хранятся в памяти).

Параметры

Без параметров.

handoff_save

Сохраняет передачу контекста разговора для последующего извлечения. Используйте это, чтобы передать контекст разговора другому AI или проекту. ## Длинные разговоры (>~100KB) Если разговор большой, сохраните первый chunk с помощью этого инструмента, затем вызывайте handoff_append повторно для оставшихся chunk'ов. Выполнение одного гигантского handoff_save может завершиться ошибкой парсинга XML / ошибкой ввода инструмента, потому что Claude Code внутренне кодирует аргументы инструментов как XML, и очень большие строки могут нарушить эту кодировку. ## Выбор формата - structured (по умолчанию): Организует содержимое по шаблону ниже. Гораздо быстрее - сокращает выходные токены до ~5-20% от исходного разговора. Лучше всего подходит для большинства передач контекста. - verbatim: Сохраняет полный дословный разговор. Используйте только когда точная формулировка важна (например, юридический текст, точные сообщения об ошибках). ## Шаблон структурированного формата (для format="structured") ## Ключевые решения - [Решение]: [Обоснование] ## Детали реализации [Что было создано/изменено, с соответствующими фрагментами кода] ## Изменения в коде [Изменённые файлы с кратким описанием] ## Открытые вопросы - [Вопрос]: [Статус/Контекст] ## Следующие шаги - [ ] Пункт действия Пропускайте секции, которые не применимы. При необходимости добавляйте свои секции.

Параметры
  • conversationstringобязательный

    Содержимое разговора. Для format='structured' используйте структурированный шаблон выше. Для format='verbatim': ПОЛНАЯ дословная переписка в формате Markdown (## User / ## Assistant): НИКОГДА не обобщайте и не сокращайте сообщения.

  • conversation_bytesinteger

    Размер содержимого диалога в байтах (рассчитывается автоматически, если не указано)

  • formatenum

    Формат вывода. 'structured' (по умолчанию): организованный шаблон - быстрее. 'verbatim': полный дословный разговор.

  • from_aistring

    Название исходного ИИ (например, 'claude', 'chatgpt')

  • from_projectstring

    Название исходного проекта (необязательно)

  • keystring

    Уникальный идентификатор для этой передачи (например, 'project-design-2024'). Автоматически генерируется, если не указан.

  • message_countinteger

    Количество сообщений в беседе (рассчитывается автоматически, если не указано)

  • next_actionstring

    Рекомендуемое следующее действие для получателя (например, «Запустить тесты и развернуть»)

  • sender_agent_idstring

    Необязательно: стабильный идентификатор отправляющего оркестратора/агента. Непрозрачный идентификатор: опустите, если не применимо.

  • spawner_dispatch_idstring

    Необязательно: dispatch ID отправляющего оркестратора, если он работает под управлением диспетчера (например, tmai Dispatch). Непрозрачный идентификатор: не указывайте, если не применимо.

  • statusenum

    Статус передачи: 'active' (по умолчанию), 'completed' или 'pending'

  • summarystringобязательный

    Краткое резюме контекста разговора (2-3 предложения)

  • tagsstring[]

    Теги для категоризации этой передачи (например, ['project:foo', 'issue:176', 'auth']). Строчные буквы, цифры, дефисы, подчёркивания, двоеточия.

  • titlestring

    Человекочитаемый заголовок для передачи. Автоматически создается из сводки, если не указан.

handoff_search

Ищет хендоффы по тегам, текстовому запросу, проекту, AI, статусу или диапазону дат. Возвращает сводки соответствующих хендоффов без полного содержимого разговора. Используйте это, чтобы находить релевантные хендоффы в многоагентных рабочих процессах.

Параметры
  • created_afterstring

    ISO дата: только передачи, созданные после этого времени

  • created_beforestring

    ISO-дата: только передачи, созданные до этого времени

  • from_aistring

    Фильтр по точному названию ИИ

  • from_projectstring

    Фильтр по точному названию проекта

  • limitinteger

    Максимум результатов для возврата (1–20, по умолчанию 10)

  • querystring

    Поиск текста в заголовке и описании (без учёта регистра)

  • statusenum

    Фильтр по статусу

  • tagsstring[]

    Найдите передачи с ЛЮБЫМ из этих тегов (например, ['project:foo', 'auth'])

  • tags_allstring[]

    Вы не указали, какие именно теги нужны. Пожалуйста, перечислите их — например: «Find handoffs with ALL of these tags: urgent, backend, review». Тогда я смогу найти подходящие handoffs.

handoff_stats

Получает статистику хранилища и текущие лимиты. Помогает следить за использованием.

Параметры

Без параметров.

0.14.0основная
0.13.1
0.13.0
0.12.0
0.11.2
0.11.1
0.11.0
0.10.1
0.10.0
0.9.3
0.9.2
0.9.1
0.9.0
0.8.0
0.7.1
0.7.0
0.6.1
0.6.0
0.5.2
0.5.1
0.5.0
0.4.2
0.4.1
0.4.0
0.3.1
0.3.0
0.2.0
0.1.6
0.1.5
0.1.4
0.1.3
0.1.2
0.1.1
0.1.0

Выберите клиент, чтобы установить conversation-handoff-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "conversation-handoff-mcp-xn68cf9t31": {
      "command": "npx",
      "args": [
        "conversation-handoff-mcp@latest"
      ]
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "conversation-handoff-mcp-xn68cf9t31": {
      "command": "npx",
      "args": [
        "conversation-handoff-mcp@latest"
      ]
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "conversation-handoff-mcp-xn68cf9t31": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "conversation-handoff-mcp@latest"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"conversation-handoff-mcp-xn68cf9t31\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"conversation-handoff-mcp@latest\"]}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "conversation-handoff-mcp-xn68cf9t31": {
      "command": "npx",
      "args": [
        "conversation-handoff-mcp@latest"
      ]
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add conversation-handoff-mcp-xn68cf9t31 -- npx conversation-handoff-mcp@latest

Либо через JSON-конфиг:

claude mcp add-json conversation-handoff-mcp-xn68cf9t31 "{\"command\":\"npx\",\"args\":[\"conversation-handoff-mcp@latest\"]}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add conversation-handoff-mcp-xn68cf9t31 -- npx conversation-handoff-mcp@latest

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.conversation-handoff-mcp-xn68cf9t31]
command = "npx"
args = ["conversation-handoff-mcp@latest"]
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите conversation-handoff-mcp, а в поле команды запуска — строку ниже:
npx conversation-handoff-mcp@latest

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "conversation-handoff-mcp-xn68cf9t31": {
      "command": "npx",
      "args": [
        "conversation-handoff-mcp@latest"
      ]
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "conversation-handoff-mcp-xn68cf9t31": {
      "command": "npx",
      "args": [
        "conversation-handoff-mcp@latest"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например conversation-handoff-mcp-xn68cf9t31.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: conversation-handoff-mcp-xn68cf9t31
    command: npx
    args:
      - "conversation-handoff-mcp@latest"
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "conversation-handoff-mcp-xn68cf9t31": {
      "command": "npx",
      "args": [
        "conversation-handoff-mcp@latest"
      ]
    }
  }
}

Похожие MCP-сервера

alfredoizdev/contextforge-mcp

alfredoizdev/contextforge-mcp

от alfredoizdev

ContextForge MCP — сервер для постоянной памяти AI-ассистентов. Сохраняет решения, архитектуру и контекст разработки между сессиями, используя семантический поиск. Поддерживает Claude Code, Cursor ...

TypeScript⭐ 2
leesgit/claude-session-continuity-mcp

leesgit/claude-session-continuity-mcp

от leesgit

Автоматически сохраняет контекст между сессиями Claude Code — больше не нужно повторять настройки. Использует семантический поиск, захват ошибок и решений, делает работу непрерывной. Для разработчи...

TypeScript⭐ 7
penfieldlabs/penfield-mcp

penfieldlabs/penfield-mcp

от penfieldlabs

MCP-сервер Penfield для долговременной памяти AI-агентов. Сохраняет решения, предпочтения и контекст между сессиями, строит граф знаний. Работает с Claude, Cursor, Windsurf и любыми MCP-инструментами.

Dockerfile⭐ 6
Skitchy/rekindle

Skitchy/rekindle

от skitchy

MCP-сервер Rekindle решает проблему потери контекста AI-ассистента между сессиями. Он ориентирует в начале, захватывает структурированные записи в конце, сохраняет контекст при сжатии. Всё локально в SQLite, без API-ключей. Полезен разработчикам Claude Code для непрерывной работы.

TypeScript⭐ 5
AlekseiMarchenko/central-intelligence

AlekseiMarchenko/central-intelligence

от alekseimarchenko

MCP сервер Central Intelligence даёт AI-агентам долговременную память: сохраняйте факты и контекст между сессиями, делитесь знаниями между инструментами. Инструменты запоминания, поиска и контекста работают с Claude Code, Cursor и другими. Данные возвращаются дословно, без перезаписи.

TypeScript⭐ 3
XJTLUmedia/Context-First-MCP

XJTLUmedia/Context-First-MCP

от xjtlumedia

MCP-сервер предотвращает потерю контекста и противоречия в длинных AI-диалогах. 37 инструментов с оркестратором context_loop автоматически проверяют контекст, выявляют неоднозначности и верифицирую...

TypeScript⭐ 2
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин