humane-proxy — MCP-сервер для Claude Code: защита запросов
Перехватывает сообщения с признаками самоповреждения или преступного намерения до передачи языковой модели. Пригодится, если нужно проверять запросы и уведомлять оператора.
claude mcp add humane-proxy -e OPENAI_API_KEY=<OPENAI_API_KEY> -e GROQ_API_KEY=<GROQ_API_KEY> -- uvx humane-proxyЧто делает humane-proxy
humane-proxy проверяет сообщения перед отправкой в языковую модель. При признаках самоповреждения он блокирует запрос и возвращает ответ с кризисными контактами; при преступном намерении запрос блокируется или помечается. Безопасные сообщения проходят дальше. В MCP-режиме агенту доступны инструменты check_message_safety, get_session_risk и list_recent_escalations.
Проверка может использовать каскад из эвристик, семантических эмбеддингов и языковой модели для рассуждений. Для эмбеддингов нужны дополнения onnx или ml, для третьего этапа — API-ключ. Слои эмбеддингов и рассуждений не обязательны: базовая установка включает эвристики и хранение в SQLite. В MCP-конфигурации Claude Code передаются OPENAI_API_KEY и GROQ_API_KEY; без нужных ключей проверка через соответствующие API не заработает.
Какие задачи решает
- перехватить запрос с признаками самоповреждения до отправки модели
- пометить сообщение с преступным намерением и уведомить оператора
- проверить безопасность отдельного сообщения через MCP-инструмент
- просмотреть риск сессии и недавние эскалации
Примеры запросов агенту
- Проверь безопасность этого сообщения через
check_message_safety. - Покажи уровень риска для этой сессии через
get_session_risk. - Покажи недавние эскалации через
list_recent_escalations.
Как установить humane-proxy
Командой платформы
claude mcp add humane-proxy -e OPENAI_API_KEY=<OPENAI_API_KEY> -e GROQ_API_KEY=<GROQ_API_KEY> -- uvx humane-proxyВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from humane-proxy <команда>
Командой платформы
codex mcp add humane-proxy --env OPENAI_API_KEY=<OPENAI_API_KEY> --env GROQ_API_KEY=<GROQ_API_KEY> -- uvx humane-proxyВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from humane-proxy <команда>
Файл настроек
{
"mcpServers": {
"humane-proxy": {
"command": "uvx",
"args": [
"humane-proxy"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"GROQ_API_KEY": "<GROQ_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from humane-proxy <команда>
Файл настроек
{
"servers": {
"humane-proxy": {
"type": "stdio",
"command": "uvx",
"args": [
"humane-proxy"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"GROQ_API_KEY": "<GROQ_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from humane-proxy <команда>
Командой платформы
gemini mcp add -e OPENAI_API_KEY=<OPENAI_API_KEY> -e GROQ_API_KEY=<GROQ_API_KEY> humane-proxy uvx humane-proxyВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from humane-proxy <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о humane-proxy
Как установить humane-proxy в Claude Code?
Выполните claude mcp add humane-proxy -e OPENAI_API_KEY=<OPENAI_API_KEY> -e GROQ_API_KEY=<GROQ_API_KEY> -- uvx humane-proxy. Команда добавит MCP-сервер с переменными API-ключей.
Что делает humane-proxy?
Он проверяет сообщения на признаки самоповреждения и преступного намерения до передачи языковой модели. Подозрительные запросы блокируются или помечаются, безопасные перенаправляются дальше.
Какие инструменты доступны агенту?
В MCP-режиме доступны check_message_safety, get_session_risk и list_recent_escalations.