@testneo/mcp-server (v1)

Сервер протокола контекста модели (MCP) для рабочих процессов обеспечения качества TestNeo.

Этот сервер предоставляет инструменты для работы с проектами и выполнения тестов TestNeo для IDE-клиентов, совместимых с MCP (Cursor, Claude Desktop, клиенты MCP для VS Code и т. д.).

Публичное зеркало (MCP Market / GitHub)

Автономное зеркало с открытым исходным кодом, используемое для листинга и обмена:

https://github.com/gururajhm-neo/testneo-mcp

Этот каталог является источником истины внутри монорепозитория TestNeo API. Чтобы обновить публичный репозиторий после внесения изменений в этот пакет, выполните:

./scripts/sync-public-mcp-repo.sh /path/to/your/local/testneo-mcp-clone

Затем выполните git commit + git push из этого клона. Лицензия: GPL-3.0 — см. LICENSE. Сообщения о безопасности: см. SECURITY.md.

Related MCP server: code-graph-mcp

Ответы

• Каждый инструмент объединяет _telemetry в результаты JSON: request_id, tool, duration_ms, backend_paths (METHOD path для каждого вызова бэкенда, отслеженного из этого процесса), а также маркер схемы telemetry_schema_version и параметры с максимальными усилиями (project_id, допускающий значение null tenant_id).

• testneo_get_failure_bundle (и шаги testneo_run_agent_workflow, требующие тщательной сортировки) могут включать suggested_nlp_patch, если include_nlp_patch_suggestion имеет значение true (по умолчанию). Полный список инструментов и контрактов: docs/MCP_TOOL_REFERENCE.md (синхронизируется с docs/mcp-tool-reference.md монорепозитория через scripts/sync-public-mcp-repo.sh).

• Предварительные условия выполнения проекта (включены по умолчанию): инструменты генерации и выполнения возвращают project_precondition_failed, если проект не разрешает реальный базовый URL http(s) (website_url или переменная окружения base_url). Отклоняет плейсхолдеры example.com. Отключайте только для особых случаев: TESTNEO_MCP_RELAX_PROJECT_PRECONDITIONS=true.

• Нормализация контракта выполнения: инструменты интеллектуального выполнения выдают contract_version: execution_intelligence.v1 и канонические статусы (queued | running | passed | failed | cancelled | unknown), сохраняя при этом исходный статус бэкенда.

Область применения v1

Инструменты с интенсивным чтением + защищенные действия записи:

• testneo_validate_connection

• testneo_list_projects

• testneo_get_project_route_map (чтение карты/профиля укрепления маршрутов на уровне проекта)

• testneo_list_unified_contexts (просмотр контекстов по имени + id)

• testneo_get_unified_context_by_name (разрешение context_id без использования UI)

• testneo_list_recent_executions

• testneo_get_execution_status

• testneo_get_execution_summary

• testneo_get_execution_logs

• testneo_get_pass_fail_trend

• testneo_watch_execution

• testneo_get_failure_bundle

• testneo_run_agent_workflow (triage_failure_workflow, rerun_decision_workflow, qa_intelligence_workflow)

• testneo_ingest_figma_context (ETL Figma + создание унифицированного контекста)

• testneo_generate_tests_from_context (унифицированный контекст -> генерация NLP-тестов; опциональное укрепление маршрутов)

• testneo_preview_generated_tests (предварительный просмотр с участием человека: NLP + черновики спецификаций Playwright)

• testneo_apply_route_hardening (только чтение: нормализация нечетких строк навигации с использованием карт фраз)

• testneo_set_project_route_map (сохранение карты маршрутов на уровне проекта; защищенная запись)

• testneo_execute_generated_test_case (защищенное выполнение утвержденных сгенерированных тестов)

• testneo_update_test_case_nlp (обновление NLP-команд для сгенерированного теста)

• testneo_export_playwright_spec (экспорт сгенерированного теста как .spec.ts для Playwright SDK)

• testneo_run_playwright_spec_preview (выполнение разобранного потока ai.run из черновика спецификации)

• testneo_figma_to_tests_workflow (сквозной процесс Figma -> Контекст -> Тесты -> Предварительный просмотр)

• testneo_search_failures

• testneo_rerun_failed (по умолчанию предварительный просмотр; выполнение требует TESTNEO_MCP_ALLOW_WRITE=true и confirm=true)

• testneo_trigger_playwright_execution (требует TESTNEO_MCP_ALLOW_WRITE=true и confirm=true)

• Интеллектуальные функции Swagger/OpenAPI

  • testneo_swagger_preview (только чтение: разбор спецификации из base64 → теги, количество эндпоинтов)

  • testneo_swagger_upload_and_generate (веб-проект: Swagger + опциональные бизнес-правила → контекст + NLP-тесты; запись + подтверждение)

  • testneo_swagger_impact_analysis / testneo_swagger_impact_actions (веб: сравнение со снимком, действия по сортировке; запись + подтверждение)

  • testneo_api_project_upload_openapi / testneo_api_project_openapi_impact (классические API-проекты; запись + подтверждение)

Настройка

cd packages/testneo-mcp-server
npm install
npm run build

Необходимые переменные окружения:

• TESTNEO_BASE_URL (пример: http://localhost:8001)

• TESTNEO_API_KEY

Опционально:

• TESTNEO_MCP_ALLOW_WRITE=false (по умолчанию)

• TESTNEO_MCP_RELAX_PROJECT_PRECONDITIONS=false (по умолчанию) — установите true только для пропуска проверок базового URL исполняемых файлов в инструментах генерации/выполнения

• TESTNEO_MCP_TELEMETRY_JSONL=false (по умолчанию) — установите true для вывода одной строки JSON на каждый вызов инструмента в stderr (outcome, request_id, duration_ms, backend_paths)

• TESTNEO_MCP_POLICY_MODE=strict (по умолчанию) или warn — поведение политики предварительных условий (strict блокирует при обнаружении проблем, warn понижает уровень некоторых проверок)

• TESTNEO_MCP_TIMEOUT_MS=20000

• TESTNEO_MCP_SWAGGER_TIMEOUT_MS=120000 (Swagger multipart + тяжелые вызовы OpenAPI impact JSON)

• TESTNEO_MCP_USER_AGENT=@testneo/mcp-server

• TESTNEO_ROUTE_HARDENING=true (по умолчанию) — установите false для глобального отключения перезаписи фраз на пути

• TESTNEO_ROUTE_PROFILE=none (по умолчанию) или saucedemo — опциональная предустановленная карта фраз (не требуется для других приложений)

• TESTNEO_ROUTE_MAP_JSON — JSON-объект фраза → путь (например, {"checkout overview":"/checkout"}); объединяется с предустановкой, когда профиль saucedemo, или используется отдельно, когда профиль none. Пути должны начинаться с /.

Генерация: testneo_generate_tests_from_context по умолчанию использует auto_align_saucedemo_route_map=true, поэтому строки навигации получают URL-адреса SauceDemo, когда предустановка аутентификации — SauceDemo, а у вас нет пользовательской карты окружения (profile none, пустая JSON-карта).

Тесты (без API)

Запускает производственную сборку, затем укрепление маршрутов, обнаружение унифицированного контекста и классификаторы предварительных условий проекта (без HTTP-вызовов к TestNeo API):

npm test

Дымовая проверка

TESTNEO_BASE_URL="http://localhost:8001" TESTNEO_API_KEY="tn_xxx" npm run smoke

Команда Cursor/IDE

Команда MCP должна запускать:

node /absolute/path/to/testneo-api/packages/testneo-mcp-server/dist/index.js

См. docs/IDE_SETUP.md для получения рекомендаций по настройке и примеров промптов.

Примечания по безопасности

• Ключ API считывается только из окружения.

• Инструмент записи по умолчанию отключен.

• Инструмент запуска требует явного подтверждения confirm=true.

• Инструменты записи поддерживают опциональный idempotency_key для предотвращения повторного выполнения при сбоях.

Агентские рабочие процессы (Фаза 2A)

testneo_run_agent_workflow добавляет уровень оркестрации поверх основных инструментов и возвращает структурированные трассировки шагов:

• triage_failure_workflow: недавние сбои -> основные пакеты сбоев -> повторяющиеся темы

• rerun_decision_workflow: недавние сбои -> планирование кандидатов на повторный запуск (сначала предварительный просмотр)

• qa_intelligence_workflow: унифицированный отчет об интеллектуальном анализе (тенденции + сбои + сортировка + предварительный просмотр повторного запуска)

Рабочие процессы Figma-to-tests (Фаза 2B)

MCP теперь поддерживает генерацию на основе контекста с одобрением человека:

• Прием метаданных Figma и связывание вывода ETL в унифицированный контекст

• Генерация NLP-тестов из сущностей контекста через существующий конвейер LangGraph

• Предварительный просмотр сгенерированных тестов в формате NLP и черновика спецификации .spec.ts для Playwright SDK

• Выполнение утвержденных сгенерированных тестов через защищенные действия записи