MCP 서버: MCP 로그 분석 및 디버깅

🎯 개요

MCP 로그 리더는 모델 컨텍스트 프로토콜(MCP) 로그를 분석하고 디버깅하는 데 도움이 되는 전문 MCP 서버입니다. 클로드가 로그 파일에 직접 접근할 수 있도록 하여 MCP 통합 문제를 쉽게 해결하고 클로드가 도구와 상호 작용하는 방식을 이해할 수 있도록 지원합니다.

다중 플랫폼 지원 : 플랫폼별 로그 경로를 사용하여 macOS, Windows 및 Linux에서 작동합니다.
스마트 필터링 : 대소문자 구분 없이 텍스트 검색으로 특정 로그 항목 찾기
페이지별 검색 : 대규모 로그 컬렉션을 효율적으로 탐색
크기 관리 : 지능형 잘라내기 기능을 통해 대용량 로그 파일을 처리합니다.
원활한 Claude 통합 : Claude Desktop과 직접 연동

🚀 빠른 시작

GitHub에서 직접 설치:

지엑스피1

빌드하고 실행:

# Compile TypeScript
npx tsc

🔌 클로드와 연결

Claude Desktop 구성에 서버를 추가합니다.

{
  "mcpServers": {
    "log-reader": {
      "command": "node",
      "args": [
        "/absolute/path/MCP-Analyzer/build"
      ]
    }
  }
}

그런 다음 Claude Desktop을 다시 시작하세요.

📋 사용 가능한 매개변수

로그 리더는 다음 매개변수를 지원합니다.

매개변수	설명	기본
`lines`	각 로그 파일에서 읽을 줄 수	100
`filter`	로그 항목을 필터링할 텍스트(대소문자 구분 없음)	""
`customPath`	로그 디렉토리에 대한 사용자 정의 경로	OS별
`fileLimit`	페이지당 읽을 수 있는 최대 파일 수	5
`page`	페이지 번호 매기기	1

💡 사용 예시

Claude에게 로그 리더 도구를 사용하도록 요청하세요.

Can you check my MCP logs for any connection errors in the last day?

또는 특정 매개변수를 사용하여:

Can you look through MCP logs with filter="error" and lines=50 to find initialization issues?

⚙️ 작동 원리

서버는 자동으로 OS를 감지하고 적절한 로그 디렉토리를 찾습니다.
모든 MCP 로그 파일을 찾아 수정 시간(최신 순)별로 정렬합니다.
요청된 로그 파일 페이지는 페이지 매김 설정에 따라 검색됩니다.
파일은 과도한 응답을 방지하기 위해 크기 제한으로 처리됩니다.
필터링된 콘텐츠는 페이지 번호 세부 정보가 포함된 구조화된 형식으로 반환됩니다.

📄 라이센스

MIT 라이센스

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

read_mcp_logs

여러 플랫폼의 로그 파일에 직접 액세스할 수 있도록 하여 모델 컨텍스트 프로토콜 로그를 분석하고 디버깅하는 데 도움이 되는 특수 MCP 서버입니다.

Related Resources

Reddit Discussion about this server

MCP Log Reader