API Debugger MCP 🚀

FastMCP를 사용해 HTTP API를 검사, 테스트, 검증, 비교, 디버깅하기 위한 프로덕션 지향 Model Context Protocol(MCP) 서버입니다.

프로젝트 배경

API 장애를 해결하려면 종종 API 클라이언트, OpenAPI 문서, 로그, 테스트 스위트, 버그 트래커를 오가야 합니다. API Debugger MCP는 MCP 호환 AI 에이전트가 이러한 조사를 수행할 수 있도록 구조화된 도구 키트를 제공합니다.

Related MCP server: mcp-api-tools

기능

• API 디버깅 및 QA를 위한 12가지 MCP 도구

• 일반적인 자격 증명 필드 및 헤더에 대한 안전한 비밀값 마스킹

• 구성 가능한 타임아웃 및 응답 크기 제한

• 기본적으로 비활성화되는 비공개/로컬 네트워크 차단

• JSON 스키마 형식의 응답 계약 검증

• 응답 본문 간 회귀 비교

• 다중 엔드포인트 상태 확인

• 자동화된 API 테스트 시나리오 생성

• 구조화된 버그 리포트 생성

• 종단간 장애 조사 워크플로

• MCP 리소스 및 재사용 가능한 프롬프트

• Docker 지원

• Pytest + coverage(커버리지)

• Ruff 린팅

• Python 3.10–3.12에 걸친 GitHub Actions CI

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

보안 참고 사항

이 서버는 기본적으로 우발적인 자격 증명 유출과 안전하지 않은 네트워크 액세스를 방지하도록 설계되었습니다.

• 일반적인 인증/쿠키/API 키 헤더는 반환 결과에서 마스킹됩니다.

• 일반적인 비밀 필드는 재귀적으로 마스킹됩니다.

• 로컬/비공개 IP 대상 요청은 기본적으로 비활성화되어 있습니다.

• 실제 자격 증명이 포함된 .env를 커밋하지 마십시오.

• 프로덕션 환경에서는 MCP 서버를 조직의 인증 및 네트워크 제어 뒤에 배치하십시오.

• 보안이 중요한 환경에서 non-user-network 요청을 활성화하기 전에 명시적 허용 목록을 추가하십시오.

프로덕션 로드맵

• OpenAPI 3.x 임포트 및 엔드포인트 검색

• OAuth/API key 비밀 제공자

• 지속적인 회귀 베이스라인

• Sentry/관측성 통합

• Jira/GitHub 이슈 생성

• 요청 상관관계 ID

• 속도 제한

• 감사 로깅

• RBAC/인증

• 비동기 병렬 health check

• 장기 실행 조사를 위한 MCP 태스크/백그라운드 실행

라이선스

MIT