API Debugger MCP 🚀

Продакшн-ориентированный сервер Model Context Protocol (MCP) для проверки, тестирования, валидации, сравнения и отладки HTTP API с помощью FastMCP.

Зачем нужен этот проект?

Отказы API часто требуют прыжков между API-клиентами, документацией OpenAPI, логами, тестовыми наборами и баг-трекерами. API Debugger MCP даёт MCP-совместимому ИИ-агенту структурированный набор инструментов для проведения таких расследований.

Related MCP server: agent-validator-mcp-server

Возможности

• 12 MCP-инструментов для отладки API и контроля качества

• Безопасное удаление секретов из распространённых полей учётных данных и заголовков

• Настраиваемые ограничения времени ожидания и размера ответа

• Блокировка запросов к частным/локальным сетям по умолчанию

• Проверка контракта ответа в стиле JSON Schema

• Регрессионное сравнение тел ответов

• Проверки работоспособности нескольких конечных точек

• Автоматическая генерация тестовых сценариев API

• Формирование структурированных отчётов об ошибках

• Сквозной процесс расследования инцидентов

• MCP-ресурс и переиспользуемый промпт

• Поддержка Docker

• Pytest + coverage

• Линтинг Ruff

• GitHub Actions CI для Python 3.10–3.12

Инструменты MCP

1. inspect_endpoint

2. send_request

3. validate_response

4. compare_responses

5. analyze_error

6. detect_api_issue

7. generate_api_tests

8. generate_bug_report

9. check_contract

10. api_health_check

11. redact_sensitive_data

12. investigate_incident

Структура проекта

api-debugger-mcp/
├── .github/workflows/ci.yml
├── docs/
├── src/api_debugger_mcp/
│   ├── analysis.py
│   ├── client.py
│   ├── config.py
│   ├── models.py
│   ├── security.py
│   ├── server.py
│   └── tools.py
├── tests/
├── .dockerignore
├── .env.example
├── .gitignore
├── Dockerfile
├── LICENSE
├── Makefile
├── docker-compose.yml
└── pyproject.toml

Быстрый старт

1. Создайте виртуальное окружение

python -m venv .venv

Windows:

.venv\Scripts\activate

macOS/Linux:

source .venv/bin/activate

2. Установите

pip install -e ".[dev]"

3. Настройте

Скопируйте .env.example в .env и укажите только значения, необходимые для вашего окружения.

Никогда не коммитьте реальные API-ключи и bearer-токены.

4. Запустите локально

Для HTTP MCP-сервера:

api-debugger-mcp

Конечная точка MCP по умолчанию:

http://localhost:8000/mcp

Для локального режима stdio:

MCP_TRANSPORT=stdio

затем выполните:

api-debugger-mcp

Docker

docker compose up --build

Сервер доступен на порту 8000.

Тестирование

pytest

Линт:

ruff check .

Форматирование:

ruff format .

Пример рабочего процесса MCP

MCP-совместимый агент может комбинировать инструменты следующим образом:

investigate_incident
    ↓
inspect_endpoint
    ↓
send_request
    ↓
detect_api_issue
    ↓
analyze_error
    ↓
check_contract
    ↓
generate_bug_report

Для регрессионного тестирования:

send_request (baseline)
        ↓
send_request (current)
        ↓
compare_responses
        ↓
validate_response

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

Этот сервер спроектирован так, чтобы по умолчанию избегать случайной утечки учётных данных и небезопасного сетевого доступа.

• Распространённые заголовки auth/cookie/API-key удаляются из возвращаемых результатов.

• Распространённые секретные поля удаляются рекурсивно.

• Запросы к локальным/частным IP-адресам по умолчанию отключены.

• Никогда не коммитьте .env с реальными учётными данными.

• В производстве размещайте MCP-сервер за аутентификацией и сетевыми средствами контроля вашей организации.

• Добавьте явный список разрешённых адресов (allowlist), прежде чем включать запросы к частным сетям в чувствительных средах.

Дорожная карта производства

• Импорт OpenAPI 3.x и обнаружение конечных точек

• Провайдеры секретов OAuth/API-ключей

• Постоянные базовые эталоны для регрессионного тестирования

• Интеграция с Sentry/системами наблюдаемости

• Создание задач в Jira/GitHub

• Идентификаторы корреляции запросов

• Ограничение частоты запросов

• Аудит-логирование

• RBAC/аутентификация

• Асинхронные параллельные проверки работоспособности

• MCP-задачи/фоновое выполнение для длительных расследований

Лицензия

MIT