Agent Coherence — Stale Write Guard (FS) — MCP-сервер для Claude Code
MCP-сервер блокирует устаревшие перезаписи общих файлов вроде plan.md и memory.json. Помогает избежать тихой потери данных при одновревнованной работе нескольких агентов.
claude mcp add stale-write-guard-fs -- uvx agent-coherenceЧто делает Agent Coherence — Stale Write Guard (FS)
Когда два агента параллельно редактируют общий файл вроде plan.md или memory.json, возникает коллизия. Один читает старый снимок, а второй уже сохранил изменения. По умолчанию побеждает последняя запись. Сервер перехватывает подобные попытки и возвращает явный отказ вместо тихой потери правок.
Механизм использует принципы протокола MESI и схему оптимистичной фиксации write_cas. Каждое чтение фиксирует версию артефакта. Если файл обновился до завершения записи, коммит отклоняется. Инварианты безопасности проверены через девять спецификаций TLA+.
Серверу требуется Python 3.11 или новее. Он координирует файлы только внутри одного хоста и не защищает от побочных эффектов во внешнем мире вроде отправки вебхуков.
Какие задачи решает
- блокировать перезапись
plan.mdустаревшими данными - отклонять неактуальные изменения через оптимистичный CAS
- координировать доступ агентов к общим файлам на одном хосте
- предотвращать тихую потерю состояния в
memory.json
Примеры запросов агенту
- Прочитай
plan.mdчерез guard перед тем, как обновлять задачи. - Зафиксируй изменения в
memory.jsonс проверкой актуальности версии.
Как установить Agent Coherence — Stale Write Guard (FS)
Командой платформы
claude mcp add stale-write-guard-fs -- uvx agent-coherenceuvx запускает команду с именем пакета; если в README она другая — uvx --from agent-coherence <команда>
Командой платформы
codex mcp add agent-coherence-stale-write-guard-fs -- uvx agent-coherenceuvx запускает команду с именем пакета; если в README она другая — uvx --from agent-coherence <команда>
Файл настроек
{
"mcpServers": {
"agent-coherence-stale-write-guard-fs": {
"command": "uvx",
"args": [
"agent-coherence"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-coherence <команда>
Файл настроек
{
"servers": {
"agent-coherence-stale-write-guard-fs": {
"type": "stdio",
"command": "uvx",
"args": [
"agent-coherence"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-coherence <команда>
Командой платформы
gemini mcp add agent-coherence-stale-write-guard-fs uvx agent-coherenceuvx запускает команду с именем пакета; если в README она другая — uvx --from agent-coherence <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Agent Coherence — Stale Write Guard (FS)
Как установить Agent Coherence — Stale Write Guard (FS) в Claude Code?
Выполните команду claude mcp add stale-write-guard-fs -- uvx agent-coherence в терминале.
Что делает stale-write-guard-fs?
Сервер отслеживает версии общих файлов на диске и отклоняет запись, если агент опирался на устаревший снимок данных. Это исключает тихую потерю чужих правок.
Какие системные требования нужны для запуска?
Для работы требуется Python версии 3.11 или новее. Утилита uvx загружает и выполняет пакет agent-coherence локально.
