Каталог MCP
conversation-handoff-mcp

conversation-handoff-mcp

Name: conversation-handoff-mcp
Availability: InStock
Author: trust-delta

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

README

11 инструментов

Версии

Установить сервер

conversation-handoff-mcp

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

日本語ドキュメント

Features

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

Инструменты были проиндексированы: 09.09.2026

handoff_add_comment

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

Параметры

authorstring
Author name for the comment (default: 'anonymous')
contentstringобязательный
The comment content
keystringобязательный
The key of the handoff to comment on

handoff_append

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

Параметры

chunkstringобязательный
Conversation text to append. Concatenated to the existing conversation as-is — include leading newlines if needed.
keystringобязательный
Key of the handoff to append to (created via handoff_save)

handoff_clear

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

Параметры

keystring
Optional: specific handoff key to clear

handoff_delete_comment

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

Параметры

comment_idstringобязательный
The ID of the comment to delete
keystringобязательный
The key of the handoff

handoff_list

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

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

Параметры

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

handoff_load

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

Параметры

keystringобязательный
The key of the handoff to load
max_messagesnumber
Optional: limit number of messages to return

handoff_merge

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

Параметры

delete_sourcesboolean
Whether to delete source handoffs after merging
keysstring[]обязательный
Keys of the handoffs to merge (minimum 2)
new_keystring
Key for the merged handoff. Auto-generated if omitted.
new_summarystring
Summary for the merged handoff. Auto-generated from source summaries if omitted.
new_titlestring
Title for the merged handoff. Auto-generated if omitted.
strategyenum
Merge strategy: 'chronological' sorts by creation time, 'sequential' keeps array order

handoff_restart

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

Параметры

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

handoff_save

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

Параметры

conversationstringобязательный
The conversation content. For format='structured': use the structured template above. For format='verbatim': the COMPLETE verbatim conversation in Markdown format (## User / ## Assistant) — NEVER summarize or shorten messages.
conversation_bytesinteger
Byte size of the conversation content (auto-calculated if omitted)
formatenum
Output format. 'structured' (default): organized template - faster. 'verbatim': complete word-for-word conversation.
from_aistring
Name of the source AI (e.g., 'claude', 'chatgpt')
from_projectstring
Name of the source project (optional)
keystring
Unique identifier for this handoff (e.g., 'project-design-2024'). Auto-generated if omitted.
message_countinteger
Number of messages in the conversation (auto-calculated if omitted)
next_actionstring
Suggested next action for the receiver (e.g., 'Run tests and deploy')
sender_agent_idstring
Optional: stable identifier of the sending orchestrator/agent. Opaque identifier — omit if not applicable.
spawner_dispatch_idstring
Optional: dispatch ID of the sending orchestrator, when it runs under one (e.g. a tmai Dispatch). Opaque identifier — omit if not applicable.
statusenum
Status of the handoff: 'active' (default), 'completed', or 'pending'
summarystringобязательный
Brief summary of the conversation context (2-3 sentences)
tagsstring[]
Tags for categorizing this handoff (e.g., ['project:foo', 'issue:176', 'auth']). Lowercase alphanumeric, hyphens, underscores, colons.
titlestring
Human-readable title for the handoff. Auto-generated from summary if omitted.

handoff_search

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

Параметры

created_afterstring
ISO date: only handoffs created after this time
created_beforestring
ISO date: only handoffs created before this time
from_aistring
Filter by exact AI name
from_projectstring
Filter by exact project name
limitinteger
Max results to return (default: 20)
querystring
Text search in title and summary (case-insensitive)
statusenum
Filter by status
tagsstring[]
Find handoffs with ANY of these tags (e.g., ['project:foo', 'auth'])
tags_allstring[]
Find handoffs with ALL of these tags

handoff_stats

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

Параметры

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

Github Сайт сервера

Конфиг для установки сервера

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #198
Звезд на Github: 6
Форков на Github: 3
Загрузок: 2 508
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 09.09 в 00:14
Идентификатор: f8vykcHzO2e7vdGZ
Категории: Агенты, Знания и память, Инструменты для разработчиков, Коммуникации, Рабочее место и продуктивность