로컬 유틸리티 MCP 서버

다양한 로컬 시스템 유틸리티에 대한 액세스를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 커서 및 기타 MCP 호환 클라이언트와 함께 사용하여 시스템 정보에 빠르게 액세스할 수 있습니다.

특징

서버는 다음과 같은 유틸리티를 제공합니다.

• 시간 및 날짜 : 요일을 포함한 현재 현지 시간과 날짜를 다양한 형식으로 가져옵니다.
• 호스트 이름 : 시스템의 호스트 이름을 가져옵니다.
• 공용 IP : 기기의 공용 IP 주소를 가져옵니다.
• 디렉토리 목록 : 지정된 디렉토리의 내용을 나열합니다.
• Node.js 버전 : 현재 실행 중인 Node.js 버전을 가져옵니다.
• 포트 검사기 : 특정 포트에서 어떤 프로세스가 실행 중인지 확인
• Think Tool : 개발 세션 동안 생각을 기록, 검색 및 분석합니다.

설치

글로벌 설치

지엑스피1

npx와 함께 사용

npx를 글로벌하게 설치하지 않고도 서버를 직접 실행할 수 있습니다.

용법

서버 시작

전역적으로 설치된 경우:

npx를 사용하면:

커서와 함께 사용

Cursor 설정에서 서버를 MCP 서버로 구성하여 Cursor와 함께 사용할 수 있습니다.

1. 커서 설정 열기
2. MCP 섹션으로 이동
3. 다음 구성으로 새로운 MCP 서버를 추가합니다.
   { "name": "localutils", "command": "npx", "args": ["localutils-mcp-server"] }

MCP 검사기 사용

MCP Inspector를 사용하여 서버를 테스트할 수 있습니다.

이렇게 하면 http://localhost:5173 에서 MCP 검사기가 시작됩니다.

사용 가능한 도구

get_time_and_date

다음을 포함한 다양한 형식으로 현재 현지 시간과 날짜를 반환합니다.

• 현지 시간
• 현지 날짜
• 요일
• ISO 8601 형식
• 유닉스 타임스탬프

get_hostname

MCP 서버를 실행하는 머신의 호스트 이름을 반환합니다.

get_public_ip

MCP 서버를 실행하는 머신의 공용 IP 주소를 반환합니다.

list_directory

지정된 디렉토리의 내용을 나열합니다.

매개변수:

• path (문자열, 필수): 나열할 디렉토리 경로

get_node_version

MCP 서버를 실행하는 환경의 Node.js 버전 정보를 반환합니다.

check_port

특정 포트에서 어떤 프로세스가 실행 중인지 확인합니다.

매개변수:

• port (숫자 또는 문자열, 필수): 확인할 포트 번호(1~65535). 문자열 값은 숫자로 자동 변환됩니다.

응답 예시(macOS/Linux):

think

타임스탬프와 함께 새로운 생각을 기록합니다.

매개변수:

• thought (문자열, 필수): 기록할 생각 내용

응답 예시:

get_thoughts

기록된 생각을 모두 검색합니다.

응답 예시:

clear_thoughts

기록된 생각을 모두 지웁니다.

응답 예시:

get_thought_stats

기록된 생각에 대한 통계를 반환합니다.

응답 예시:

개발

건물

개발 모드에서 실행

테스트

Git 워크플로

이 저장소에는 각 커밋 전에 서버를 자동으로 빌드하는 pre-commit 후크가 포함되어 있습니다. 이를 통해 빌드 파일이 저장소에서 항상 최신 상태로 유지됩니다.

빌드 폴더는 git 저장소에 포함되어 있어서 npx에서 패키지를 먼저 빌드하지 않고도 쉽게 사용할 수 있습니다.

저장소를 복제한 후 사전 커밋 후크를 설정하려면:

이렇게 하면 종속성이 설치되고 Husky를 통해 사전 커밋 후크가 설정됩니다.

특허

MIT