systemd-coredump MCP 서버

systemd-coredump 기능과 상호 작용하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이를 통해 MCP 지원 애플리케이션은 시스템 코어 덤프에 접근, 관리 및 분석할 수 있습니다.

특징

• 시스템에서 사용 가능한 모든 코어덤프를 나열합니다.
• 특정 코어덤프에 대한 자세한 정보를 얻으세요
• 지정된 위치에 코어덤프 파일 추출
• 시스템에서 코어덤프 제거

필수 조건

• Node.js 18+ 및 npm
• systemd-coredump는 시스템에 설치 및 구성되어야 합니다.
• coredumpctl 명령줄 유틸리티를 사용할 수 있어야 합니다.

설치

npm에서 (권장)

글로벌 설치

지엑스피1

로컬 설치

출처에서

1. 저장소를 복제하거나 소스 코드를 다운로드하세요
2. 종속성 설치:

3. 서버를 빌드하세요:

구성

MCP 설정 구성 파일에 서버를 추가합니다.

npm에서 전역적으로 설치하는 경우:

로컬로 npm에서 설치한 경우:

소스에서 설치한 경우:

용법

사용 가능한 도구

서버는 다음과 같은 도구를 제공합니다.

1. list_coredumps : 시스템에서 사용 가능한 모든 코어덤프를 나열합니다.
   { "name": "list_coredumps" }
2. get_coredump_info : 특정 코어덤프에 대한 자세한 정보를 가져옵니다.
   { "name": "get_coredump_info", "arguments": { "id": "2023-04-20 12:34:56-12345" } }
3. extract_coredump : 코어덤프를 파일로 추출합니다.
   { "name": "extract_coredump", "arguments": { "id": "2023-04-20 12:34:56-12345", "outputPath": "/path/to/output/core.dump" } }
4. remove_coredump : 시스템에서 코어덤프를 제거합니다.
   { "name": "remove_coredump", "arguments": { "id": "2023-04-20 12:34:56-12345" } }
5. get_coredump_config : 시스템의 현재 코어 덤프 구성을 가져옵니다.
   { "name": "get_coredump_config" }
   이 도구는 다음을 포함하여 현재 코어 덤프 구성에 대한 정보를 반환합니다.
   • 코어 덤프가 활성화되어 있는지 여부
   • 현재 핵심 패턴
   • 코어 크기 제한
   • systemd가 코어 덤프를 처리하는지 여부
6. set_coredump_enabled : 코어 덤프 생성을 활성화하거나 비활성화합니다.
   { "name": "set_coredump_enabled", "arguments": { "enabled": true } }
   enabled 를 true 로 설정하면 코어 덤프가 활성화되고, false 로 설정하면 코어 덤프가 비활성화됩니다. 참고: 이 설정은 현재 셸의 ulimit 설정을 변경합니다. 시스템 전체에 영구적인 변경을 적용하려면 루트 권한과 시스템 설정 파일 수정이 필요합니다.
7. get_stacktrace : GDB를 사용하여 코어덤프에서 스택 추적을 가져옵니다.
   { "name": "get_stacktrace", "arguments": { "id": "2023-04-20 12:34:56-12345" } }
   이 도구는 GDB를 사용하여 코어 덤프에서 포맷된 스택 추적을 추출합니다. 참고: 시스템에 GDB 디버거가 설치되어 있어야 합니다.

사용 가능한 리소스

서버는 두 가지 유형의 리소스를 노출합니다.

1. 코어덤프 정보
   • URI 형식: coredump:///<id>
   • 자세한 코어덤프 정보가 포함된 JSON을 반환합니다.
2. 스택 추적
   • URI 형식: stacktrace:///<id>
   • 코어덤프에서 포맷된 스택 추적을 반환합니다.

여기서 <id> <timestamp>-<pid> 형식의 코어덤프에 대한 고유 식별자입니다.

예를 들어:

권한에 대한 참고 사항

일부 작업, 특히 코어 덤프를 추출하거나 제거하는 경우 높은 권한이 필요할 수 있습니다. MCP 서버를 실행하는 사용자에게 시스템 코어 덤프에 액세스할 수 있는 적절한 권한이 있는지 확인하십시오.

특허

MIT