systemd-coredump MCP 서버
systemd-coredump 기능과 상호 작용하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이를 통해 MCP 지원 애플리케이션은 시스템 코어 덤프에 접근, 관리 및 분석할 수 있습니다.
특징
- 시스템에서 사용 가능한 모든 코어덤프를 나열합니다.
- 특정 코어덤프에 대한 자세한 정보를 얻으세요
- 지정된 위치에 코어덤프 파일 추출
- 시스템에서 코어덤프 제거
필수 조건
- Node.js 18+ 및 npm
- systemd-coredump는 시스템에 설치 및 구성되어야 합니다.
coredumpctl 명령줄 유틸리티를 사용할 수 있어야 합니다.
설치
npm에서 (권장)
글로벌 설치
지엑스피1
로컬 설치
npm install @taskjp/server-systemd-coredump
출처에서
- 저장소를 복제하거나 소스 코드를 다운로드하세요
- 종속성 설치:
cd systemd-coredump-server
npm install
- 서버를 빌드하세요:
구성
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": []
}
용법
사용 가능한 도구
서버는 다음과 같은 도구를 제공합니다.
- list_coredumps : 시스템에서 사용 가능한 모든 코어덤프를 나열합니다.
{
"name": "list_coredumps"
}
- get_coredump_info : 특정 코어덤프에 대한 자세한 정보를 가져옵니다.
{
"name": "get_coredump_info",
"arguments": {
"id": "2023-04-20 12:34:56-12345"
}
}
- extract_coredump : 코어덤프를 파일로 추출합니다.
{
"name": "extract_coredump",
"arguments": {
"id": "2023-04-20 12:34:56-12345",
"outputPath": "/path/to/output/core.dump"
}
}
- remove_coredump : 시스템에서 코어덤프를 제거합니다.
{
"name": "remove_coredump",
"arguments": {
"id": "2023-04-20 12:34:56-12345"
}
}
- get_coredump_config : 시스템의 현재 코어 덤프 구성을 가져옵니다.
{
"name": "get_coredump_config"
}
- 코어 덤프가 활성화되어 있는지 여부
- 현재 핵심 패턴
- 코어 크기 제한
- systemd가 코어 덤프를 처리하는지 여부
- set_coredump_enabled : 코어 덤프 생성을 활성화하거나 비활성화합니다.
{
"name": "set_coredump_enabled",
"arguments": {
"enabled": true
}
}
enabled 를 true 로 설정하면 코어 덤프가 활성화되고, false 로 설정하면 코어 덤프가 비활성화됩니다. 참고: 이 설정은 현재 셸의 ulimit 설정을 변경합니다. 시스템 전체에 영구적인 변경을 적용하려면 루트 권한과 시스템 설정 파일 수정이 필요합니다. - get_stacktrace : GDB를 사용하여 코어덤프에서 스택 추적을 가져옵니다.
{
"name": "get_stacktrace",
"arguments": {
"id": "2023-04-20 12:34:56-12345"
}
}
사용 가능한 리소스
서버는 두 가지 유형의 리소스를 노출합니다.
- 코어덤프 정보
- URI 형식:
coredump:///<id> - 자세한 코어덤프 정보가 포함된 JSON을 반환합니다.
- 스택 추적
- URI 형식:
stacktrace:///<id> - 코어덤프에서 포맷된 스택 추적을 반환합니다.
여기서 <id> <timestamp>-<pid> 형식의 코어덤프에 대한 고유 식별자입니다.
예를 들어:
coredump:///2023-04-20 12:34:56-12345
stacktrace:///2023-04-20 12:34:56-12345
권한에 대한 참고 사항
일부 작업, 특히 코어 덤프를 추출하거나 제거하는 경우 높은 권한이 필요할 수 있습니다. MCP 서버를 실행하는 사용자에게 시스템 코어 덤프에 액세스할 수 있는 적절한 권한이 있는지 확인하십시오.
특허
MIT