# glassbox-framework

Проверяет ответы языковых моделей через разбор утверждений, оценку уверенности и состязательные тесты. Сервер формирует отчёт Trust Card с проверяемым вердиктом.

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

## Что делает

MCP-сервер принимает пару из вопроса и ответа, прогоняя её через конвейер верификации. На выходе формируется карточка Trust Card, куда входят атомарные утверждения с цепочками рассуждений, итоговый вердикт (`trust`, `caution` или `reject`) и детерминированный идентификатор аудита на базе SHA-256. Оценка уверенности ECS рассчитывается по пяти взвешенным измерениям с открытой формулой.

Сервер написан на Node.js под именем `@glassbox-framework/mcp` и предоставляет шесть инструментов с валидацией через Zod. Среди них — полная проверка `glassbox_verify_answer`, запуск состязательных тестов Glassbox Court через `glassbox_red_team`, расчёт метрик `glassbox_score_ecs` и сборка карточки без вызова моделей через `glassbox_generate_trust_card`.

Для выполнения запросов серверу обязательно требуется переменная окружения `ANTHROPIC_API_KEY`. Без неё состязательные тесты на выявление фабрикаций и подмены контекста просто не запустятся.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `ANTHROPIC_API_KEY`, `GLASSBOX_MODEL`, `GLASSBOX_MAX_TOKENS`, `GLASSBOX_ECS_MODE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env GLASSBOX_MODEL=<GLASSBOX_MODEL> --env GLASSBOX_MAX_TOKENS=<GLASSBOX_MAX_TOKENS> --env GLASSBOX_ECS_MODE=<GLASSBOX_ECS_MODE> --transport stdio glassbox-framework -- npx -y @glassbox-framework/mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add glassbox-framework --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env GLASSBOX_MODEL=<GLASSBOX_MODEL> --env GLASSBOX_MAX_TOKENS=<GLASSBOX_MAX_TOKENS> --env GLASSBOX_ECS_MODE=<GLASSBOX_ECS_MODE> -- npx -y @glassbox-framework/mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "glassbox-framework": {
            "command": "npx",
            "args": [
                "-y",
                "@glassbox-framework/mcp"
            ],
            "env": {
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
                "GLASSBOX_MODEL": "<GLASSBOX_MODEL>",
                "GLASSBOX_MAX_TOKENS": "<GLASSBOX_MAX_TOKENS>",
                "GLASSBOX_ECS_MODE": "<GLASSBOX_ECS_MODE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "glassbox-framework": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@glassbox-framework/mcp"
            ],
            "env": {
                "ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
                "GLASSBOX_MODEL": "<GLASSBOX_MODEL>",
                "GLASSBOX_MAX_TOKENS": "<GLASSBOX_MAX_TOKENS>",
                "GLASSBOX_ECS_MODE": "<GLASSBOX_ECS_MODE>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -e GLASSBOX_MODEL=<GLASSBOX_MODEL> -e GLASSBOX_MAX_TOKENS=<GLASSBOX_MAX_TOKENS> -e GLASSBOX_ECS_MODE=<GLASSBOX_ECS_MODE> glassbox-framework npx -y @glassbox-framework/mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- проверить сгенерированный ответ ИИ на наличие вымышленных фактов
- сопоставить ответ модели с правилами пользовательской конституции
- рассчитать открытый балл эпистемической уверенности ECS
- получить воспроизводимый SHA-256 хэш для аудита результатов

## Примеры запросов агенту
- Проверь через `glassbox_verify_answer` этот медицинский совет и сопоставь его с требованием ссылаться на врачей.
- Выдели атомарные утверждения и цепочки рассуждений из ответа с помощью `glassbox_extract_claims`.
- Запусти состязательные тесты `glassbox_red_team`, чтобы найти манипуляции источниками и контекстные атаки.

## Похожие
- [llm-testing](https://affpapa.org/nevibecode/skills/llm-testing.md) — скилл · 547 установок
- [ai-prompt-engineering-safety-review](https://affpapa.org/nevibecode/skills/ai-prompt-engineering-safety-review.md) — скилл · 10327 установок
- [ai-risk-management](https://affpapa.org/nevibecode/skills/ai-risk-management.md) — скилл · 313 установок
- [humane-proxy](https://affpapa.org/nevibecode/mcp/humane-proxy.md) — MCP-сервер · ★ 27
- [ai-prompt-engineering-safety-best-practices](https://affpapa.org/nevibecode/rules/ai-prompt-engineering-safety-best-practices.md) — правило · ★ 40451
- [payment-provider-framework](https://affpapa.org/nevibecode/skills/payment-provider-framework.md) — скилл · 979 установок

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