MCP PC Control Server
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 - 환경 변수 읽기 (하나 또는 전체)
Related MCP server: Enhanced File Operations MCP Server
설치
이 저장소를 복제하거나 다운로드합니다.
종속성을 설치합니다:
npm install프로젝트를 빌드합니다:
npm run build사용법
서버 실행
서버는 stdio를 통해 통신하며 MCP 클라이언트와 함께 사용하도록 설계되었습니다:
npm startClaude 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 requiredlist_processes
{ filter?: string } // optional substring filter on process nameget_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매개변수를 늘리십시오.일부 명령은 특정 환경 변수가 필요할 수 있습니다.
Available Tools
11 toolscreate_directoryA
Create a new directory or ensure a directory exists. Can create multiple nested directories in one operation. If the directory already exists, this operation will succeed silently.
Inputs: path (required).
delete_directoryA
Permanently delete a directory and all of its contents, including all files and subdirectories. This is a recursive operation that cannot be undone. Use with extreme caution.
Inputs: path (required).
delete_fileA
Permanently delete a file from the file system. This operation cannot be undone. The file is immediately removed from the storage device.
Inputs: path (required).
edit_fileA
Make line-based edits to a text file. Provide original lines and their replacements. Returns a git-style diff showing the changes made. Each edit replaces exact line sequences with new content.
Inputs: path (required), edits (required).
execute_commandA
Execute shell commands on the system. SECURITY WARNING: This tool provides direct system access. Only use with trusted commands. Commands run with the same permissions as the MCP server process.
Inputs: command (required), workingDirectory.
get_file_infoA
Retrieve detailed metadata about a file or directory, including size, creation time, modification time, access time, type, and permissions. This does not read file contents.
Inputs: path (required).
list_directoryA
Get a detailed listing of all files and directories in a specified path. Results include names, types (file/directory), sizes, and modification times. Useful for understanding directory structure and finding files.
Inputs: path (required).
move_fileA
Move or rename files and directories. Can move files between directories and rename them in a single operation. If the destination exists, the operation will fail.
Inputs: source (required), destination (required).
read_fileA
Read the complete contents of a file from the file system. Handles various text encodings and returns the full file content. Use this to examine file contents before editing.
Inputs: path (required).
search_filesA
Recursively search for files matching a pattern in a directory. Supports wildcards (* and **) and returns matching file paths. Useful for finding files by name or extension.
Inputs: path (required), pattern (required).
write_fileA
Create a new file or completely overwrite an existing file with new content. Use with caution as it will overwrite existing files without warning. Handles text content with proper encoding.
Inputs: path (required), content (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool has a clearly distinct purpose with no ambiguity: create_directory vs. delete_directory, read_file vs. edit_file vs. write_file, list_directory vs. search_files, etc. The descriptions reinforce unique roles, such as get_file_info for metadata only and execute_command for shell operations, preventing misselection.
All tool names follow a consistent verb_noun pattern using snake_case, such as create_directory, delete_file, and execute_command. This predictable naming scheme makes it easy for agents to understand and use the tools without confusion from mixed conventions.
With 11 tools, the server is well-scoped for PC control, covering essential file system operations (CRUD for files/directories), metadata retrieval, searching, and command execution. Each tool earns its place without being overwhelming or insufficient for the domain.
The tool set provides complete coverage for file system management: create, read, edit, write, delete, move, list, search, and get info for files and directories, plus execute_command for broader system control. There are no obvious gaps, enabling agents to handle full workflows without dead ends.
Maintenance
Related MCP Connectors
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Related MCP Servers
- AlicenseDqualityDmaintenanceEnables AI models to perform file system operations (reading, creating, and listing files) on a local file system through a standardized Model Context Protocol interface.3ISC
- FlicenseNot gradedqualityCmaintenanceA comprehensive Model Context Protocol server that provides over 50 file and system management tools for AI models, including navigation, file operations, search, compression, and system information capabilities.-
- AlicenseAqualityDmaintenanceA comprehensive Model Context Protocol server that enables AI assistants to interact with and manage Windows systems, providing capabilities for file system operations, process management, system information retrieval, registry operations, service management, network diagnostics, and performance monitoring.716 npm6Apache 2.0
- AlicenseAqualityDmaintenanceEnables file management operations on the desktop including creating, reading, editing, moving, renaming, deleting, and listing files through the Model Context Protocol.6ISC