conversation-handoff-mcp

conversation-handoff-mcp

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

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

  • 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

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

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

Параметры

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

    The key of the handoff to comment on

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

    The comment content

  • authorstring

    Author name for the comment (default: 'anonymous')

handoff_append

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

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

Параметры

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

    Key of the handoff to append to (created via handoff_save)

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

    Conversation text to append. Concatenated to the existing conversation as-is — include leading newlines if needed.

handoff_clear

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

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

Параметры

  • keystring

    Optional: specific handoff key to clear

handoff_delete_comment

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

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

Параметры

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

    The key of the handoff

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

    The ID of the comment to delete

handoff_list

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

Handoff List

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

Параметры

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

handoff_load

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

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

Параметры

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

    The key of the handoff to load

  • max_messagesnumber

    Optional: limit number of messages to return

handoff_merge

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

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

Параметры

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

    Keys of the handoffs to merge (minimum 2)

  • new_keystring

    Key for the merged handoff. Auto-generated if omitted.

  • new_titlestring

    Title for the merged handoff. Auto-generated if omitted.

  • new_summarystring

    Summary for the merged handoff. Auto-generated from source summaries if omitted.

  • delete_sourcesboolean

    Whether to delete source handoffs after merging

  • strategyenum

    Merge strategy: 'chronological' sorts by creation time, 'sequential' keeps array order

    chronologicalsequential
handoff_restart

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

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

Параметры

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

handoff_save

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

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

Параметры

  • keystring

    Unique identifier for this handoff (e.g., 'project-design-2024'). Auto-generated if omitted.

  • titlestring

    Human-readable title for the handoff. Auto-generated from summary if omitted.

  • formatenum

    Output format. 'structured' (default): organized template - faster. 'verbatim': complete word-for-word conversation.

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

    Brief summary of the conversation context (2-3 sentences)

  • 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.

  • from_aistring

    Name of the source AI (e.g., 'claude', 'chatgpt')

  • from_projectstring

    Name of the source project (optional)

  • message_countinteger

    Number of messages in the conversation (auto-calculated if omitted)

  • conversation_bytesinteger

    Byte size of the conversation content (auto-calculated if omitted)

  • statusenum

    Status of the handoff: 'active' (default), 'completed', or 'pending'

    activecompletedpending
  • next_actionstring

    Suggested next action for the receiver (e.g., 'Run tests and deploy')

  • tagsstring[]

    Tags for categorizing this handoff (e.g., ['project:foo', 'issue:176', 'auth']). Lowercase alphanumeric, hyphens, underscores, colons.

handoff_search

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

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

Параметры

  • tagsstring[]

    Find handoffs with ANY of these tags (e.g., ['project:foo', 'auth'])

  • tags_allstring[]

    Find handoffs with ALL of these tags

  • querystring

    Text search in title and summary (case-insensitive)

  • from_projectstring

    Filter by exact project name

  • from_aistring

    Filter by exact AI name

  • statusenum

    Filter by status

    activecompletedpending
  • created_afterstring

    ISO date: only handoffs created after this time

  • created_beforestring

    ISO date: only handoffs created before this time

  • limitinteger

    Max results to return (default: 20)

handoff_stats

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

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

Параметры

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

Другие проверенные MCP-сервера

dagger/container-use

dagger/container-use

официальный

MCP сервер container-use даёт агентам (Claude Code, Cursor) работать параллельно в изолированных контейнерах - безопасно и без конфликтов. Полезен разработчикам: видит лог действий и даёт доступ к ...

Go3914
ppl-ai/modelcontextprotocol

ppl-ai/modelcontextprotocol

MCP-инструмент от Perplexity, который подключает к AI-ассистентам веб-поиск, глубокие исследования и аналитические рассуждения через Sonar-модели и Search API. Идеален для разработчиков, создающих интеллектуальных агентов с доступом к актуальной информации из сети.

TypeScript2388
vectorize-io/hindsight

vectorize-io/hindsight

официальный

MCP сервер Hindsight наделяет AI-агентов долговременной памятью — они учатся на опыте, а не просто запоминают диалоги. Использует биомиметические структуры данных для извлечения фактов и ментальных моделей, превосходя по точности RAG и графы знаний. Подходит для персонализации чат-ботов и создани...

Python18555
docker/hub-mcp

docker/hub-mcp

официальный

MCP-сервер для Docker Hub: позволяет LLM искать, рекомендовать и управлять контейнерными образами через естественный язык. Упрощает работу с репозиториями, экономя время разработчиков.

TypeScript157
flux159/mcp-server-kubernetes

flux159/mcp-server-kubernetes

MCP сервер для подключения к Kubernetes и управления кластером через kubectl и Helm. Выполняет операции с ресурсами, масштабирование, деплой, диагностику и port-forwarding. Полезен разработчикам и ...

TypeScript1460
vectara/vectara-mcp

vectara/vectara-mcp

официальный

MCP-сервер для RAG с Vectara: семантический поиск, генерация и коррекция галлюцинаций. Помогает AI-агентам выдавать фактологически точные ответы с верификацией. Совместим с Claude Desktop.

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

Лука Никитин