Установка

Склонируйте репозиторий и установите зависимости:

git clone https://github.com/0detect/mcp-server.git 0detect-mcp
cd 0detect-mcp
npm install

Понадобится Node.js 22 или новее (сервер использует глобальный fetch). Проверить версию: node --version.

Запуск

Запустите сервер вручную, чтобы убедиться, что всё работает:

npm start

Эквивалентные варианты: npm run mcp или напрямую npx tsx src/index.ts из корня репозитория.

Процесс рассчитан на долгую работу — MCP-клиент держит его открытым на протяжении всей сессии. На старте сервер читает ~/.0detect/config.json, чтобы получить localApiPort и localApiKey, и затем ждёт JSON-RPC-трафик в stdio.

Если 0detect запущен и конфиг корректен, процесс остаётся живым и ничего не пишет в stdout. Все диагностические сообщения уходят в stderr, чтобы не нарушать MCP-поток.

Проверка локального API

Перед тем как подключать сервер к MCP-клиенту, убедитесь, что 0detect Local API доступен:

curl http://localhost:56789/health-check

Успешный ответ означает, что MCP-сервер сможет общаться с 0detect. Если запрос падает, сначала разбирайтесь с локальным API — см. Решение проблем.

Разработка

Проверка типов:

npm run typecheck

Технологии: @modelcontextprotocol/sdk (opens in a new tab), Zod v4 для схем инструментов, TypeScript, tsx для запуска.

Вступление Настройка клиента