# landmine

MCP-сервер landmine, который отслеживает открытые баги в точных версиях npm и PyPI из локфайла и останавливает агента, если тот пишет код, попадающий под известную проблему.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10 у репозитория
- Автор: devanshranjan10
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/devanshranjan10/landmines
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/landmine

## Что делает

Работает в два этапа: `landmine scan` читает локфайл, находит открытые GitHub-ишью, поданные именно против закреплённых версий, выбирает из комментариев полезные обходные пути и записывает индекс в `.landmine/index.json`. Команда `landmine install --rules` добавляет хук перед редактированием и разделы известных багов в `AGENTS.md` и `CLAUDE.md`.

Хук срабатывает офлайн за доли секунды до каждой правки, если файл содержит символ из индекса и дополнительные условия ишью выполнены — например, там есть драйвер базы, который упомянут в баге. Агент видит ссылку на ишью и цитату с обходным путём. Если агент применяет правку повторно, хук пропускает её.

Для больших проектов с десятками зависимостей список ишью в `CLAUDE.md` может не уместиться в контекст. В таком случае лучше оставить только хук или удалённый MCP-сервер `https://landmine.tech/mcp`, который агент опрашивает по запросу — токен GitHub не требуется.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://landmine.tech/mcp`
- Переменные окружения: `GITHUB_TOKEN` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http landmine https://landmine.tech/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env GITHUB_TOKEN=<GITHUB_TOKEN> --transport stdio landmine -- npx -y landmines
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add landmine --url https://landmine.tech/mcp
```

2. **Командой платформы**
```bash
codex mcp add landmine --env GITHUB_TOKEN=<GITHUB_TOKEN> -- npx -y landmines
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "landmine": {
            "url": "https://landmine.tech/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "landmine": {
            "command": "npx",
            "args": [
                "-y",
                "landmines"
            ],
            "env": {
                "GITHUB_TOKEN": "<GITHUB_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "landmine": {
            "type": "http",
            "url": "https://landmine.tech/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "landmine": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "landmines"
            ],
            "env": {
                "GITHUB_TOKEN": "<GITHUB_TOKEN>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http landmine https://landmine.tech/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e GITHUB_TOKEN=<GITHUB_TOKEN> landmine npx -y landmines
```
Вместо <…> подставьте свои значения

## Когда брать
- остановить агента перед правкой, если та использует API с открытым багом в точной версии локфайла
- найти обходной путь из комментариев к ишью и передать агенту
- проверить, есть ли у ошибки открытый баг в закреплённой версии библиотеки
- добавить секцию известных багов в документацию для агента

## Примеры запросов агенту
- Запусти `npx landmines scan`, а потом `npx landmines install --rules` — добавь хук и секцию в `CLAUDE.md`.
- Проверь, есть ли открытый баг в `drizzle-orm` версии 0.36.0 для метода `$client.end()`.
- Найди обходные пути для ишью в `react-hook-form`, которые относятся к версии из `package-lock.json`.

## Похожие
- [git-workflow](https://affpapa.org/nevibecode/skills/netresearch-dtt-gmbh-git-workflow.md) — скилл · 759 установок
- [Vynix](https://affpapa.org/nevibecode/mcp/vynix.md) — MCP-сервер · ★ 10 у репозитория
- [shellcheck-configuration](https://affpapa.org/nevibecode/skills/shellcheck-configuration.md) — скилл · 11533 установки
- [SnagRelay](https://affpapa.org/nevibecode/mcp/snagrelay.md) — MCP-сервер
- [static-code-analysis](https://affpapa.org/nevibecode/skills/static-code-analysis.md) — скилл · 624 установки
- [implementing-secret-scanning-with-gitleaks](https://affpapa.org/nevibecode/skills/implementing-secret-scanning-with-gitleaks.md) — скилл · 577 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
