Демонстрация MCP-сервера

Этот проект содержит Python MCP-серверы для анализа сбоев тестов, ориентированные на QA, построенные с использованием FastMCP.

Текущая структура

mcp-server-demo/
├── FailureAnalysisFromLogs.py
├── README.md
├── logs/
├── pyproject.toml
├── testFailureAnalysis.py
└── uv.lock

Related MCP server: mcp-log-analyzer

Что включает в себя этот проект

• testFailureAnalysis.py

  • analyze_test_failure

  • cluster_failures

  • detect_flaky_tests

• FailureAnalysisFromLogs.py

  • analyze_test_failure

  • Читает и классифицирует локальные файлы .log из папки logs/

• logs/

  • Примеры журналов сбоев, используемые MCP-сервером на основе журналов

• pyproject.toml

  • Конфигурация версии Python и зависимостей

• uv.lock

  • Зафиксированные версии зависимостей для воспроизводимой установки

• .vscode/mcp.json

  • Записи MCP-сервера для test-failure-analysis, test-failure-analysis-from-logs и mcp-atlassian

Предварительные требования

• Python 3.11 или новее

• uv

• Доступ в Интернет для первой установки зависимостей

Установка

Из корня репозитория:

cd mcp-server-demo
uv sync

Запуск сервера

Запустите MCP-сервер на основе входных данных с помощью:

uv run python testFailureAnalysis.py

Запустите MCP-сервер на основе журналов с помощью:

uv run python FailureAnalysisFromLogs.py

Доступные инструменты

analyze_test_failure

Анализирует неудачный тест, используя имя теста, трассировку стека и журналы, затем возвращает вероятную категорию сбоя и рекомендацию.

analyze_test_failure в FailureAnalysisFromLogs.py

Анализирует локальные файлы .log из папки logs/ и возвращает классификацию сбоя, вероятную первопричину, рекомендацию и важные строки ошибки. Он может анализировать все журналы, конкретное имя теста или точное имя файла журнала.

cluster_failures

Группирует похожие сбои по сигнатуре трассировки стека, чтобы повторяющиеся шаблоны было легче обнаружить.

detect_flaky_tests

Просматривает исторические результаты прохождения/сбоев и идентифицирует тесты, которые демонстрируют нестабильное поведение.

Дополнительная локальная конфигурация MCP

Корень репозитория содержит .vscode/mcp.json, который может использоваться инструментами с поддержкой MCP для настройки локального сервера во время разработки. Он включает записи для test-failure-analysis, test-failure-analysis-from-logs и mcp-atlassian.

Atlassian MCP

Локальная конфигурация MCP включает запись сервера mcp-atlassian для доступа к Jira.

Как использовать

Используйте настроенную запись mcp-atlassian из .vscode/mcp.json в вашем клиенте с поддержкой MCP.

Чтобы запустить его вручную, используйте:

JIRA_URL=<your-jira-url> \
JIRA_USERNAME=<your-jira-username> \
JIRA_API_TOKEN=<your-jira-api-token> \
uvx mcp-atlassian

Устранение неполадок

• Если uv недоступен, установите его и перезапустите терминал.

• Если установка зависимостей не удалась, убедитесь, что активен Python 3.11+.

• Если сервер не запускается, выполните uv sync снова внутри mcp-server-demo.

Изображение рабочего процесса в папке image по адресу image/project-workflow.png