toolkit-mcp-server — MCP-сервер для Claude Code: обзор и запуск
Набор утилит для создания идентификаторов, хешей, генерации QR-кодов, кодирования строк и геолокации IP-адресов. Пригодится при рутинной разработке бэкенда.
claude mcp add --transport http toolkit-mcp-server https://toolkit.caseyjhand.com/mcpЧто делает toolkit-mcp-server
Сервер объединяет 7 инструментов для типовых операций с данными. Встроенный генератор создаёт идентификаторы UUIDv7 или ULID партиями до 1000 штук с монотонным ростом даже внутри одной миллисекунды. Доступны расчёт дайджестов sha256 или sha512, безопасное сравнение хешей, а также декодирование строк формата base64, hex и url-encoded с пропуском пробелов в PEM-структурах.
Модуль QR-кодов формирует векторный SVG либо текстовые полублоки для терминала с поддержкой уровней коррекции от L до H. Для сетевых задач сервер определяет координаты, город и ASN публичного адреса через бесплатный сервис ip-api с ограничением до 45 одиночных вызовов за минуту.
Инструменты проверки хоста закрыты защитными флагами. Без явной передачи переменных TOOLKIT_ENABLE_NET_DIAGNOSTICS и TOOLKIT_ENABLE_SYSTEM_INFO сервер заблокирует запуск пинга или чтение сведений о процессоре.
Какие задачи решает
- сгенерировать пачку сортируемых идентификаторов UUIDv7 или ULID
- вычислить sha256 хеш или проверить SRI-строку пакета
- создать QR-код в виде SVG или полублоков для вывода в консоль
- раскодировать base64 или hex без потери бинарных байтов
- определить страну, ASN и координаты по публичному IP
Примеры запросов агенту
- Сгенерируй 10 штук UUIDv7 для новой схемы базы данных.
- Создай QR-код для ссылки https://toolkit.caseyjhand.com/mcp в формате SVG с уровнем коррекции M.
- Вычисли sha256 хеш для этой строки и выведи результат в hex.
Как установить toolkit-mcp-server
1Командой платформы: удалённый сервер
claude mcp add --transport http toolkit-mcp-server https://toolkit.caseyjhand.com/mcp2Командой платформы
claude mcp add --env MCP_LOG_LEVEL=<MCP_LOG_LEVEL> --env TOOLKIT_ENABLE_NET_DIAGNOSTICS=<TOOLKIT_ENABLE_NET_DIAGNOSTICS> --env TOOLKIT_ENABLE_SYSTEM_INFO=<TOOLKIT_ENABLE_SYSTEM_INFO> --env TOOLKIT_ALLOW_PRIVATE_NETWORK=<TOOLKIT_ALLOW_PRIVATE_NETWORK> --env TOOLKIT_GEO_API_KEY=<TOOLKIT_GEO_API_KEY> --transport stdio toolkit-mcp-server -- npx -y @cyanheads/toolkit-mcp-serverВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
1Командой платформы: удалённый сервер
codex mcp add toolkit-mcp-server --url https://toolkit.caseyjhand.com/mcp2Командой платформы
codex mcp add toolkit-mcp-server --env MCP_LOG_LEVEL=<MCP_LOG_LEVEL> --env TOOLKIT_ENABLE_NET_DIAGNOSTICS=<TOOLKIT_ENABLE_NET_DIAGNOSTICS> --env TOOLKIT_ENABLE_SYSTEM_INFO=<TOOLKIT_ENABLE_SYSTEM_INFO> --env TOOLKIT_ALLOW_PRIVATE_NETWORK=<TOOLKIT_ALLOW_PRIVATE_NETWORK> --env TOOLKIT_GEO_API_KEY=<TOOLKIT_GEO_API_KEY> -- npx -y @cyanheads/toolkit-mcp-serverВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"toolkit-mcp-server": {
"url": "https://toolkit.caseyjhand.com/mcp"
}
}
}{
"mcpServers": {
"toolkit-mcp-server": {
"command": "npx",
"args": [
"-y",
"@cyanheads/toolkit-mcp-server"
],
"env": {
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
"TOOLKIT_ENABLE_NET_DIAGNOSTICS": "<TOOLKIT_ENABLE_NET_DIAGNOSTICS>",
"TOOLKIT_ENABLE_SYSTEM_INFO": "<TOOLKIT_ENABLE_SYSTEM_INFO>",
"TOOLKIT_ALLOW_PRIVATE_NETWORK": "<TOOLKIT_ALLOW_PRIVATE_NETWORK>",
"TOOLKIT_GEO_API_KEY": "<TOOLKIT_GEO_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"toolkit-mcp-server": {
"type": "http",
"url": "https://toolkit.caseyjhand.com/mcp"
}
}
}{
"servers": {
"toolkit-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cyanheads/toolkit-mcp-server"
],
"env": {
"MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
"TOOLKIT_ENABLE_NET_DIAGNOSTICS": "<TOOLKIT_ENABLE_NET_DIAGNOSTICS>",
"TOOLKIT_ENABLE_SYSTEM_INFO": "<TOOLKIT_ENABLE_SYSTEM_INFO>",
"TOOLKIT_ALLOW_PRIVATE_NETWORK": "<TOOLKIT_ALLOW_PRIVATE_NETWORK>",
"TOOLKIT_GEO_API_KEY": "<TOOLKIT_GEO_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
1Командой платформы: удалённый сервер
gemini mcp add -t http toolkit-mcp-server https://toolkit.caseyjhand.com/mcp2Командой платформы
gemini mcp add -e MCP_LOG_LEVEL=<MCP_LOG_LEVEL> -e TOOLKIT_ENABLE_NET_DIAGNOSTICS=<TOOLKIT_ENABLE_NET_DIAGNOSTICS> -e TOOLKIT_ENABLE_SYSTEM_INFO=<TOOLKIT_ENABLE_SYSTEM_INFO> -e TOOLKIT_ALLOW_PRIVATE_NETWORK=<TOOLKIT_ALLOW_PRIVATE_NETWORK> -e TOOLKIT_GEO_API_KEY=<TOOLKIT_GEO_API_KEY> toolkit-mcp-server npx -y @cyanheads/toolkit-mcp-serverВместо <…> подставьте свои значения. Ещё 9 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о toolkit-mcp-server
Как установить toolkit-mcp-server в Claude Code?
Выполните команду claude mcp add --transport http toolkit-mcp-server https://toolkit.caseyjhand.com/mcp в терминале.
Что делает toolkit-mcp-server?
Сервер даёт модели доступ к вычислению хешей, созданию идентификаторов UUID и ULID, рисованию QR-кодов, преобразованию base64 и поиску геоданных по IP.
Почему инструменты системной диагностики не отвечают сразу после добавления?
Команды toolkit_check_network и toolkit_check_system отключены в коде по умолчанию. Для их активации нужно явно передать флаги окружения TOOLKIT_ENABLE_NET_DIAGNOSTICS и TOOLKIT_ENABLE_SYSTEM_INFO.
