stalemap

stalemap — MCP-сервер сообщества (автор — Umair). Сообщает агентам, какие npm-зависимости изменились после их обучения. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
Umair
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
linux, macos, windows
Языки
typescript

Уровень риска: high

Пишет блок заметок в AGENTS.md или CLAUDE.md и конфигурацию агента; отправляет названия и версии пакетов в npm, GitHub и models.dev; может использовать GITHUB_TOKEN.

Настройка клиентов

codex
{
    "code": "stalemap setup --agent codex",
    "lang": "bash",
    "notes": "Из README; в реальной установке ещё не проверялось",
    "verified": "docs"
}

Что умеет

stalemap решает проблему устаревших знаний ИИ-агентов. Модели учатся на данных до определённой даты, и если проект закрепляет более новые версии библиотек, агент пишет код под старый API: maxSteps для AI SDK 7, required_error для zod 4, middleware.ts для Next 16. stalemap находит зависимости, изменившиеся после даты обучения вашей модели, и сообщает агенту, что поменялось, тремя способами:

  • Заметки — короткий ранжированный список изменений в AGENTS.md или CLAUDE.md, который агент читает перед началом работы. Блок стоит между маркерами stalemap:start и stalemap:end, текст вне его не трогается.
  • Проверка при правке — после каждой правки запускается собственный type-check проекта. Если код использует изменившийся API, агент сразу получает ошибку компилятора и подходящую заметку. Отдельно сообщается о коде, который компилируется, но использует перенесённое: ключи конфигурации, переименованные члены и файлы.
  • search_changes — MCP-инструмент, которому агент задаёт вопрос своими словами и получает подходящие изменения с источниками (ранжирование BM25).

MCP-инструменты: search_changes, package_changes, project_changes и check_notes. Работает с проектами на JavaScript и TypeScript в Claude Code, Cursor, Codex, OpenCode и любом MCP-клиенте.

Как определяются изменения: по модели (флаг --model или модель из настроек Claude Code, Codex, OpenCode, Gemini CLI) и дате её обучения из models.dev; для каждой зависимости берётся последний стабильный релиз минимум за 30 дней до этой даты. Сравниваются .d.ts-файлы обеих версий через TypeScript compiler API (удалённые, переименованные экспорты, новые обязательные параметры, @deprecated), читаются changelog и GitHub Releases. Бюджет заметок по умолчанию — 1800 токенов.

В слепом заранее зарегистрированном тесте на 66 задачах агенты claude-sonnet-5-5 прошли 89% сессий со stalemap против 68% без помощи и 73% с простым хуком tsc --noEmit. Проект ранний и поддерживается одним человеком.

Кому подойдёт

  • Разработчикам на JavaScript и TypeScript, чьи зависимости новее знаний модели.
  • Командам на Next.js, AI SDK, zod и других быстро меняющихся библиотеках.
  • Тем, кто хочет проверять заметки в CI через GitHub Action.

Похожие серверы — в категории разработка.

Установка

Плагин Claude Code добавляет хук SessionStart (заметки в контекст сессии), хук PostToolUse (проверка после каждой правки), MCP-сервер и два навыка. Хуки и сервер запускают npx -y stalemap@latest. Для других агентов команда stalemap setup --agent с значением cursor, codex, opencode или claude пишет заметки, регистрирует MCP-сервер и ставит проверку как хук после правки — в виде файлов проекта, которые можно закоммитить; --dry-run только покажет изменения. Автор предупреждает, что в реальных установках Cursor, Codex и OpenCode это ещё не проверялось.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

/plugin marketplace add Umair/stalemap
/plugin install stalemap@stalemap

Комментарии во второй вкладке: вместо cursor можно указать codex, opencode или claude, а --dry-run печатает изменения, ничего не записывая.

Проверка

Выполните npx stalemap — команда покажет, что изменилось, и блок, который она запишет. В агенте спросите: «Как теперь задать resolve alias в next.config?» — сработает search_changes.

Примеры задач

Какие из наших зависимостей изменились после даты обучения модели? Перечисли главные несовместимые изменения.
Перед обновлением zod до 4 версии найди изменения, которые затронут наш код.

Риски

  • Запись в проект. sync и setup --agent пишут блок в AGENTS.md или CLAUDE.md и файлы конфигурации агента.
  • Сеть. Названия и версии пакетов уходят в реестр npm, GitHub и models.dev; исходный код не загружается. С --llm, --examples или --guides фрагменты изменений типов, release notes и имена импортируемых API отправляются Claude.
  • Токен. Для GitHub используется GITHUB_TOKEN или вход gh, если они есть.
  • Кэш. Данные кэшируются в ~/.cache/stalemap.

Частые вопросы

Отправляется ли мой код?

Нет, сканирование импортов локальное; в сеть уходят названия и версии пакетов.

Для каких языков подходит?

Для проектов на JavaScript и TypeScript.

Можно ли проверять в CI?

Да, npx stalemap check завершается с ошибкой, если блок отсутствует или устарел; есть GitHub Action.

Основы протокола — на странице что такое MCP-сервер.

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

GitHub MCP Server

Официальный MCP-сервер GitHub: репозитории, issues, пул-реквесты и Actions для ИИ-ассистента.

Риск: high Лицензия: MIT ★ 34 571

Git

Эталонный MCP-сервер для работы с локальными Git-репозиториями: чтение истории, поиск, просмотр изменений и коммиты.

Риск: high Лицензия: NOASSERTION ★ 92 089

GitDiagram

Архитектурные диаграммы, пояснения и исходники Mermaid для публичных репозиториев GitHub.

Риск: medium Лицензия: MIT ★ 18 997

git-mcp

Удалённый сервер, который отдаёт ИИ-ассистенту документацию любого репозитория или проекта на GitHub.

Риск: medium Лицензия: Apache-2.0 ★ 8 527

Источники