# toolkit-mcp-server

Набор утилит для создания идентификаторов, хешей, генерации QR-кодов, кодирования строк и геолокации IP-адресов. Пригодится при рутинной разработке бэкенда.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18
- Автор: cyanheads
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/cyanheads/toolkit-mcp-server
- Обновлён: 2026-10-17
- HTML: https://affpapa.org/nevibecode/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` сервер заблокирует запуск пинга или чтение сведений о процессоре.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://toolkit.caseyjhand.com/mcp`
- Переменные окружения: `MCP_LOG_LEVEL`, `TOOLKIT_ENABLE_NET_DIAGNOSTICS`, `TOOLKIT_ENABLE_SYSTEM_INFO`, `TOOLKIT_ALLOW_PRIVATE_NETWORK`, `TOOLKIT_GEO_API_KEY`, `TOOLKIT_GEO_BASE_URL`, `TOOLKIT_GEO_CACHE_TTL_SECONDS`, `TOOLKIT_GEO_RATE_LIMIT_PER_MIN`, `TOOLKIT_GEO_BATCH_RATE_LIMIT_PER_MIN`, `MCP_TRANSPORT_TYPE` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http toolkit-mcp-server https://toolkit.caseyjhand.com/mcp
```

2. **Командой платформы**
```bash
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 сервера

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add toolkit-mcp-server --url https://toolkit.caseyjhand.com/mcp
```

2. **Командой платформы**
```bash
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 сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "toolkit-mcp-server": {
            "url": "https://toolkit.caseyjhand.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "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 сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "toolkit-mcp-server": {
            "type": "http",
            "url": "https://toolkit.caseyjhand.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "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 сервера

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http toolkit-mcp-server https://toolkit.caseyjhand.com/mcp
```

2. **Командой платформы**
```bash
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 сервера

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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