Iris — MCP-сервер для Claude Code: что делает и как установить
Локально оценивает запуски ИИ-агентов на безопасность, галлюцинации и расходы без внешних аккаунтов.
claude mcp add --env IRIS_API_KEY=<IRIS_API_KEY> --env IRIS_API_KEY_FILE=<IRIS_API_KEY_FILE> --env IRIS_ALLOW_UNAUTHENTICATED=<IRIS_ALLOW_UNAUTHENTICATED> --env IRIS_DB_PATH=<IRIS_DB_PATH> --env IRIS_SQLITE_DRIVER=<IRIS_SQLITE_DRIVER> --transport stdio iris -- npx -y @iris-eval/mcp-serverЧто делает Iris
Iris сохраняет журнал запусков агента в локальную базу SQLite. Для анализа сервер применяет 26 детерминированных правил без обращения к внешним нейросетям. Они выявляют попытки взлома промпта, утечки персональных сведений, признаки галлюцинаций и превышение лимитов расходов.
Для семантических проверок предусмотрен дополнительный LLM-судья с жёстким лимитом бюджета на одну оценку. Статистика и карточки сбоев открываются в локальной панели управления по адресу http://localhost:6920.
Для работы требуется Node.js 22.13 или новее. Без этой версии Node сервер не запустится. Все данные остаются на диске, если не настроен экспорт трейсов через OpenTelemetry или отправка вебхуков.
Какие задачи решает
- находить маркеры галлюцинаций и сбои вызовов инструментов
- блокировать утечки персональных данных в ответах агента
- выявлять скрытые инъекции промптов в анализируемом тексте
- контролировать финансовые расходы на каждый прогон
Примеры запросов агенту
- Проверь последний запуск агента на утечки PII и маркеры галлюцинаций
- Покажи отчёт по расходам токенов и вызовам инструментов в базе Iris
- Оцени безопасность вывода агента через детерминированные правила Iris
Как установить Iris
Командой платформы
claude mcp add --env IRIS_API_KEY=<IRIS_API_KEY> --env IRIS_API_KEY_FILE=<IRIS_API_KEY_FILE> --env IRIS_ALLOW_UNAUTHENTICATED=<IRIS_ALLOW_UNAUTHENTICATED> --env IRIS_DB_PATH=<IRIS_DB_PATH> --env IRIS_SQLITE_DRIVER=<IRIS_SQLITE_DRIVER> --transport stdio iris -- npx -y @iris-eval/mcp-serverВместо <…> подставьте свои значения. Ещё 26 переменных окружения — в README сервера
Командой платформы
codex mcp add iris --env IRIS_API_KEY=<IRIS_API_KEY> --env IRIS_API_KEY_FILE=<IRIS_API_KEY_FILE> --env IRIS_ALLOW_UNAUTHENTICATED=<IRIS_ALLOW_UNAUTHENTICATED> --env IRIS_DB_PATH=<IRIS_DB_PATH> --env IRIS_SQLITE_DRIVER=<IRIS_SQLITE_DRIVER> -- npx -y @iris-eval/mcp-serverВместо <…> подставьте свои значения. Ещё 26 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"iris": {
"command": "npx",
"args": [
"-y",
"@iris-eval/mcp-server"
],
"env": {
"IRIS_API_KEY": "<IRIS_API_KEY>",
"IRIS_API_KEY_FILE": "<IRIS_API_KEY_FILE>",
"IRIS_ALLOW_UNAUTHENTICATED": "<IRIS_ALLOW_UNAUTHENTICATED>",
"IRIS_DB_PATH": "<IRIS_DB_PATH>",
"IRIS_SQLITE_DRIVER": "<IRIS_SQLITE_DRIVER>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 26 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"iris": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@iris-eval/mcp-server"
],
"env": {
"IRIS_API_KEY": "<IRIS_API_KEY>",
"IRIS_API_KEY_FILE": "<IRIS_API_KEY_FILE>",
"IRIS_ALLOW_UNAUTHENTICATED": "<IRIS_ALLOW_UNAUTHENTICATED>",
"IRIS_DB_PATH": "<IRIS_DB_PATH>",
"IRIS_SQLITE_DRIVER": "<IRIS_SQLITE_DRIVER>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 26 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e IRIS_API_KEY=<IRIS_API_KEY> -e IRIS_API_KEY_FILE=<IRIS_API_KEY_FILE> -e IRIS_ALLOW_UNAUTHENTICATED=<IRIS_ALLOW_UNAUTHENTICATED> -e IRIS_DB_PATH=<IRIS_DB_PATH> -e IRIS_SQLITE_DRIVER=<IRIS_SQLITE_DRIVER> iris npx -y @iris-eval/mcp-serverВместо <…> подставьте свои значения. Ещё 26 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Iris
Как установить Iris в Claude Code?
Выполните команду `claude mcp add mcp-server -e IRIS_API_KEY=<IRIS_API_KEY> -e IRIS_ANTHROPIC_API_KEY=<IRIS_ANTHROPIC_API_KEY> -e IRIS_OPENAI_API_KEY=<IRIS_OPENAI_API_KEY> -e IRIS_WEBHOOK_SECRET=<IRIS_WEBHOOK_SECRET> -- npx -y @iris-eval/mcp-server`.
Что делает MCP-сервер Iris?
Он фиксирует результаты работы агента в локальной SQLite-базе и оценивает их по 26 встроенным правилам безопасности, качества и стоимости.
Какие системные требования нужны для запуска Iris?
Платформе необходим Node.js версии 22.13 или новее. Версию окружения можно проверить командой node --version.
