Windows Command Line MCP Server

by alxspiker
Verified

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides access to Git commands for version control within the allowlist of permitted operations

  • Allows project creation and management for Node.js applications in a sandboxed environment

  • Allows execution of npm commands for package management within the security constraints

Windows 명령줄 MCP 서버

AI 모델이 Windows 명령줄 기능과 안전하고 효율적으로 상호 작용할 수 있도록 하는 안전한 MCP(Model Context Protocol) 서버입니다.

개요

Windows 명령줄 MCP 서버는 AI 모델과 Windows 시스템 운영 간의 강력하고 안전한 연결 고리를 제공합니다. 엄격한 보안 프로토콜을 유지하면서 명령 실행, 프로젝트 생성 및 시스템 정보 검색을 제어할 수 있습니다.

주요 특징

🔒 강화된 보안

  • 포괄적인 명령 허용 목록
  • 엄격한 입력 검증
  • 파괴적인 시스템 운영 방지
  • 구성 가능한 보안 수준

🛠 개발 도구 지원

  • React, Node.js 및 Python 프로젝트 생성
  • 안전한 개발 환경 상호 작용
  • 개발 워크플로에 대한 확장된 명령 지원

🖥 시스템 상호 작용 기능

  • Windows CLI 명령 실행
  • PowerShell 스크립트 실행
  • 시스템 및 네트워크 정보 검색
  • 프로세스 및 서비스 관리

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Windows 명령줄 MCP 서버를 자동으로 설치하려면:

지엑스피1

필수 조건

  • Node.js 16 이상
  • npm 또는 yarn
  • 윈도우 운영체제

설정

git clone https://github.com/alxspiker/Windows-Command-Line-MCP-Server.git cd Windows-Command-Line-MCP-Server npm install npm run build

용법

명령줄 옵션

  • 기본 모드: 미리 정의된 안전 명령을 사용합니다.
  • --allow-all : 확장 모드로 실행(추가 예방 조치 포함)
  • 사용자 정의 명령 목록은 인수로 지정될 수 있습니다.

프로젝트 생성

내장된 프로젝트 생성 도구를 사용하여 안전하게 새 프로젝트를 생성하세요.

  • 지원되는 프로젝트 유형: React, Node.js, Python
  • 샌드박스 ~/AIProjects 디렉토리에 생성된 프로젝트

사용 가능한 도구

  1. execute_command : Windows CLI 명령 실행
  2. execute_powershell : PowerShell 스크립트 실행
  3. create_project : 새로운 개발 프로젝트를 안전하게 생성합니다.
  4. list_running_processes : 활성 시스템 프로세스 검색
  5. get_system_info : 시스템 구성 세부 정보 수집
  6. get_network_info : 네트워크 어댑터 정보 검색
  7. get_scheduled_tasks : 시스템 작업 나열 및 쿼리
  8. get_service_info : Windows 서비스 관리 및 쿼리
  9. list_allowed_commands : 서버에서 실행할 수 있는 모든 명령을 나열합니다.

Claude와 함께 데스크톱 사용

Claude for Desktop과 함께 이 서버를 사용하려면:

  1. 위의 설정 지침을 사용하여 서버를 빌드하세요.
  2. claude_desktop_config.json 에 추가하세요:
{ "mcpServers": { "windows-cmd": { "command": "node", "args": ["/path/to/dist/index.js"] } } }

/path/to/dist/index.js dist 디렉토리에 있는 빌드된 index.js 파일의 절대 경로로 바꿉니다.

  1. 데스크톱용 Claude 재시작
  2. 이제 Claude에게 Windows 시스템 작업을 수행하도록 요청하여 도구를 사용할 수 있습니다.

보안 고려 사항

허용된 명령

기본적으로 안전한 명령만 허용됩니다.

  • 시스템 정보 검색
  • 네트워크 구성
  • 프로세스 관리
  • 개발 도구 상호 작용

차단된 작업

다음을 포함한 위험한 명령은 항상 차단됩니다.

  • 디스크 포맷
  • 사용자 관리
  • 시스템 종료
  • 중요한 레지스트리 수정

구성

허용되는 명령을 지정하거나 구성 플래그를 사용하여 서버의 동작을 사용자 지정합니다.

# Run with default safe commands node dist/index.js # Run with specific allowed commands node dist/index.js dir echo npm git # Run in extended mode (use with caution) node dist/index.js --allow-all

기여하다

  1. 저장소를 포크하세요
  2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
  3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
  4. 브랜치에 푸시( git push origin feature/amazing-feature )
  5. 풀 리퀘스트 열기

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

감사의 말

  • 모델 컨텍스트 프로토콜 사양에서 영감을 받음
  • 보안과 유연성을 염두에 두고 개발되었습니다.

버전 기록

  • 0.3.0 : README에 언급된 모든 도구(시스템 정보, 네트워크 정보, 프로세스 관리, 서비스 정보)를 구현했습니다.
  • 0.2.0 : 프로젝트 생성 기능 추가, 개발 도구 확장
  • 0.1.0 : 기본 명령 실행 기능을 갖춘 초기 릴리스

지원하다

문제, 질문 또는 제안 사항이 있으시면 GitHub에서 이슈를 열어 주세요.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

AI 모델이 Windows 명령줄 기능과 안전하게 상호 작용할 수 있도록 하는 보안된 모델 컨텍스트 프로토콜 서버로, 시스템 명령의 제어된 실행, 프로젝트 생성 및 시스템 정보 검색이 가능합니다.

  1. Overview
    1. Key Features
      1. 🔒 Enhanced Security
      2. 🛠 Development Tools Support
      3. 🖥 System Interaction Capabilities
    2. Installation
      1. Installing via Smithery
      2. Prerequisites
      3. Setup
    3. Usage
      1. Command Line Options
      2. Project Creation
      3. Available Tools
    4. Using with Claude for Desktop
      1. Security Considerations
        1. Allowed Commands
        2. Blocked Operations
      2. Configuration
        1. Example
      3. Contributing
        1. License
          1. Acknowledgements
            1. Version History
              1. Support
                ID: 976txj1j30