MCP PC 제어 서버

파일 작업, 디렉토리 관리, 명령 실행, 시스템 검사 및 프로세스 관리를 포함한 포괄적인 PC 제어 기능을 제공하는 강력한 Model Context Protocol (MCP) 서버입니다. AI 어시스턴트(Claude, GPT, Gemini 등)가 호스트 머신을 완벽하고 효율적으로 제어할 수 있도록 설계되었습니다.

기능

파일 작업

read_file - 적절한 인코딩으로 전체 파일 내용 읽기
read_file_lines - 파일에서 특정 범위의 줄 읽기 (대용량 파일에 효율적)
write_file - 새 파일 생성 또는 기존 파일 덮어쓰기
append_to_file - 덮어쓰지 않고 파일에 내용 추가
edit_file - diff 출력과 함께 정밀한 텍스트 기반 편집 수행
copy_file - 파일을 새 위치로 복사 (원본 유지)
delete_file - 파일 시스템에서 파일 제거
move_file - 파일 및 디렉토리 이동 또는 이름 변경
get_file_info - 상세 파일 메타데이터 가져오기 (크기, 타임스탬프, 권한, 읽기 가능 여부)

디렉토리 작업

create_directory - 디렉토리 생성 (중첩 생성 지원)
list_directory - 상세 정보와 함께 디렉토리 내용 나열
delete_directory - 디렉토리 및 해당 내용을 재귀적으로 삭제
search_files - 이름 패턴과 일치하는 파일을 재귀적으로 검색

콘텐츠 검색

search_in_files - 파일 내 텍스트 내용을 Grep과 유사하게 검색 (선택적 파일 패턴 필터링 및 대소문자 구분 안 함 모드 지원)

시스템 작업

execute_command - 선택적 작업 디렉토리 및 구성 가능한 타임아웃으로 셸 명령 실행
get_system_info - OS, CPU, 메모리, 가동 시간, 호스트 이름 및 네트워크 인터페이스 세부 정보 가져오기
list_processes - 선택적 이름 필터로 실행 중인 프로세스 나열
get_environment - 환경 변수 읽기 (하나 또는 전체)

설치

이 저장소를 복제하거나 다운로드합니다.
종속성을 설치합니다:

npm install

프로젝트를 빌드합니다:

npm run build

사용법

서버 실행

서버는 stdio를 통해 통신하며 MCP 클라이언트와 함께 사용하도록 설계되었습니다:

npm start

Claude Desktop 설정

이 서버를 Claude Desktop 구성 파일에 추가합니다:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "pc-control": {
      "command": "node",
      "args": ["/absolute/path/to/first_mcp/build/index.js"]
    }
  }
}

/absolute/path/to/first_mcp를 이 프로젝트 디렉토리의 실제 절대 경로로 바꿉니다.

다른 AI 클라이언트와의 설정

모든 MCP 호환 클라이언트(Claude, Cursor, Windsurf, Continue 등)는 동일한 stdio 전송 방식을 사용하여 이 서버에 연결할 수 있습니다. 클라이언트가 node를 사용하여 빌드된 build/index.js를 가리키도록 합니다.

npx를 사용한 예시 (대안)

{
  "mcpServers": {
    "pc-control": {
      "command": "npx",
      "args": ["-y", "mcp-pc-control-server"]
    }
  }
}

사용 가능한 도구

read_file

{ path: string }

read_file_lines

{
  path: string,
  start: number,  // 1-based, inclusive
  end?: number    // 1-based, inclusive (omit to read to end)
}

write_file

{ path: string, content: string }

append_to_file

{ path: string, content: string }

edit_file

{
  path: string,
  edits: [{ oldText: string, newText: string }]
}

copy_file

{ source: string, destination: string }

create_directory

{ path: string }

list_directory

{ path: string }

delete_file

{ path: string }

delete_directory

{ path: string }

move_file

{ source: string, destination: string }

get_file_info

{ path: string }

execute_command

{
  command: string,
  workingDirectory?: string,
  timeout?: number  // ms, default 30000
}

search_files

{ path: string, pattern: string }  // pattern supports * and **

search_in_files

{
  path: string,
  query: string,
  filePattern?: string,     // e.g. "*.ts"
  caseSensitive?: boolean   // default false
}

get_system_info

{}  // no arguments required

list_processes

{ filter?: string }  // optional substring filter on process name

get_environment

{ variable?: string }  // omit to get all env vars

보안 고려 사항

경고: 이 서버는 강력한 파일 시스템 및 명령 실행 기능을 제공합니다.

파일 액세스: 프로세스에 권한이 있는 모든 파일을 읽고, 쓰고, 삭제할 수 있습니다.
명령 실행: 임의의 셸 명령을 실행할 수 있습니다.
샌드박스 없음: 작업이 샌드박스 처리되거나 제한되지 않습니다.

권장 사항:

신뢰할 수 있는 MCP 클라이언트와만 사용하십시오.
필요한 최소한의 권한으로 실행하십시오.
execute_command 및 delete_directory 도구 사용 시 주의하십시오.
프로덕션 환경에서는 추가적인 액세스 제어를 구현하는 것을 고려하십시오.
민감한 환경에서는 모든 작업을 검토하십시오.

개발

빌드

npm run build

감시 모드

npm run watch

프로젝트 구조

.
├── src/
│   └── index.ts          # Main server implementation
├── build/                # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.md

라이선스

MIT

기여

기여를 환영합니다! 문제 제기나 풀 리퀘스트를 자유롭게 제출해 주세요.

문제 해결

Claude Desktop에 서버가 나타나지 않는 경우

claude_desktop_config.json의 경로가 절대 경로이며 올바른지 확인하십시오.
빌드 디렉토리가 존재하고 index.js가 포함되어 있는지 확인하십시오.
구성 변경 후 Claude Desktop을 다시 시작하십시오.
Claude Desktop 로그에서 오류를 확인하십시오.

권한 오류

서버 프로세스에 필요한 파일 시스템 권한이 있는지 확인하십시오.
Unix 시스템에서는 ls -la로 파일/디렉토리 권한을 확인하십시오.
필요한 작업에 적절한 사용자 권한으로 실행하십시오.

명령 실행 문제

작업 디렉토리가 존재하고 액세스 가능한지 확인하십시오.
셸 명령이 운영 체제에 적합한지 확인하십시오.
오래 실행되는 명령의 경우 timeout 매개변수를 늘리십시오.
일부 명령은 특정 환경 변수가 필요할 수 있습니다.