systemd-coredump MCP 서버

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

특징

• 시스템에서 사용 가능한 모든 코어덤프를 나열합니다.

• 특정 코어덤프에 대한 자세한 정보를 얻으세요

• 지정된 위치에 코어덤프 파일 추출

• 시스템에서 코어덤프 제거

Related MCP server: LLDB-MCP

필수 조건

• Node.js 18+ 및 npm

• systemd-coredump는 시스템에 설치 및 구성되어야 합니다.

• coredumpctl 명령줄 유틸리티를 사용할 수 있어야 합니다.

설치

npm에서 (권장)

글로벌 설치

지엑스피1

로컬 설치

npm install @taskjp/server-systemd-coredump

출처에서

1. 저장소를 복제하거나 소스 코드를 다운로드하세요

2. 종속성 설치:

cd systemd-coredump-server
npm install

3. 서버를 빌드하세요:

npm run build

구성

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

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

"systemd-coredump": {
  "command": "systemd-coredump-server",
  "args": [],
  "disabled": false,
  "autoApprove": []
}

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

"systemd-coredump": {
  "command": "node",
  "args": ["node_modules/@taskjp/server-systemd-coredump/build/index.js"],
  "disabled": false,
  "autoApprove": []
}

소스에서 설치한 경우:

"systemd-coredump": {
  "command": "node",
  "args": ["/path/to/systemd-coredump-server/build/index.js"],
  "disabled": false,
  "autoApprove": []
}

용법

사용 가능한 도구

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

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> 형식의 코어덤프에 대한 고유 식별자입니다.

예를 들어:

coredump:///2023-04-20 12:34:56-12345
stacktrace:///2023-04-20 12:34:56-12345

권한에 대한 참고 사항

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

특허

MIT