# scopeblind-mcp

Шлюз безопасности для stdio MCP-серверов. Логирует вызовы инструментов в фоновом режиме и блокирует опасные операции по локальным правилам.

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

## Что делает

Шлюз работает как прозрачный stdio-прокси между MCP-клиентом и целевым сервером. Он перехватывает JSON-RPC запросы `tools/call`. Остальные служебные сообщения вроде `initialize` или `tools/list` проходят без изменений. По умолчанию включён режим наблюдения (shadow mode), поэтому прокси лишь записывает данные о вызовах в `stderr` со специальным префиксом `[PROTECT_MCP]`, не прерывая выполнение.

Для реальной защиты подключается файл политики. Правила позволяют явно заблокировать инструмент (`block: true`), установить ограничение по частоте (например, `5/hour`) или потребовать уровень допуска. Команда `protect-mcp init` генерирует локальные ключи Ed25519. После этого шлюз начинает формировать подписанные квитанции в `.protect-mcp-receipts.jsonl` и открывает доступ к ним по адресу `http://127.0.0.1:9876/receipts`.

Обычный запуск прокси не подписывает запросы и ничего не блокирует. Защита срабатывает только при передаче флага `--enforce` вместе с файлом правил. Уровень сессии в стандартном CLI-режиме остаётся `unknown`, пока внешняя интеграция не передаст статус допуска программно.

## Требования
- Нужно: Node.js (команды через npx)

## Установка

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

**Командой платформы**
```bash
claude mcp add scopeblind-mcp -- npx -y scopeblind-mcp
```

### Codex

**Командой платформы**
```bash
codex mcp add scopeblind-mcp -- npx -y scopeblind-mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "scopeblind-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "scopeblind-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "scopeblind-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "scopeblind-mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add scopeblind-mcp npx -y scopeblind-mcp
```

## Когда брать
- логировать вызовы инструментов MCP-серверов в фоновом режиме
- блокировать вызовы опасных функций по списку правил
- ограничивать частоту выполнения затратных операций
- создавать подписанные квитанции Ed25519 для аудита

## Примеры запросов агенту
- Запусти protect-mcp init, чтобы создать шаблон конфигурации и ключи подписи.
- Собери файл аудита командой `npx protect-mcp bundle --output audit.json.`
- Проверь статус шлюза и локальные квитанции через protect-mcp status.

## Похожие
- [Vaara](https://affpapa.org/nevibecode/mcp/vaara.md) — MCP-сервер · ★ 15
- [Signet MCP Tools](https://affpapa.org/nevibecode/mcp/signet-mcp-tools.md) — MCP-сервер · ★ 40
- [GateCore Marketplace](https://affpapa.org/nevibecode/mcp/gatecore-marketplace.md) — MCP-сервер
- [protect-mcp-setup](https://affpapa.org/nevibecode/skills/protect-mcp-setup.md) — скилл · 6000 установок
- [audit-chain](https://affpapa.org/nevibecode/commands/audit-chain.md) — команда · ★ 41823
- [veritasacta-verify](https://affpapa.org/nevibecode/plugins/veritasacta-verify.md) — плагин · ★ 8

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