mcp-pc-info

hunss777/mcp-pc-info

3.1

If you are the rightful owner of mcp-pc-info and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The MCP PC Information Server allows access to detailed PC information through the Model Context Protocol, providing insights into system, CPU, memory, disk, network, process, and battery status.

MCP PC Information Server

Claude Desktop에서 PC 정보에 접근할 수 있는 MCP(Model Context Protocol) 서버입니다.

🚀 기능

  • 시스템 정보: OS, 아키텍처, 호스트명 등
  • CPU 정보: 코어 수, 사용률, 주파수 등
  • 메모리 정보: 총/사용/가용 메모리, 스왑 등
  • 디스크 정보: 마운트 포인트, 용량, 사용률 등
  • 네트워크 정보: 송수신 바이트, 패킷, 연결 수 등
  • 프로세스 정보: 실행 중인 프로세스 (상위 10개)
  • 배터리 정보: 배터리 상태 (노트북인 경우)

📦 설치 및 설정

1. 저장소 클론

git clone https://github.com/yourusername/mcp-pc-info.git
cd mcp-pc-info

2. 의존성 설치

pip3 install psutil

3. Claude Desktop 설정

Claude Desktop에서 MCP 서버를 추가하려면:

  1. Claude Desktop을 열고 설정으로 이동
  2. "Add server" 클릭
  3. 다음 정보 입력:
    • Name: PC Info Server
    • Command: python3
    • Args: /path/to/mcp-pc-info/final_mcp_server.py
    • Working Directory: /path/to/mcp-pc-info

🎯 사용법

Claude Desktop에서 사용

MCP 서버가 연결되면 다음과 같은 질문을 할 수 있습니다:

  • "내 PC의 시스템 정보를 보여줘"
  • "CPU 사용률과 코어 수를 확인해줘"
  • "메모리 사용량을 보여줘"
  • "디스크 용량을 체크해줘"
  • "실행 중인 프로세스를 보여줘"
  • "네트워크 상태를 확인해줘"
  • "배터리 상태를 보여줘"
  • "PC 전체 정보를 보여줘"

명령줄에서 직접 사용

# 시스템 정보
python3 final_mcp_server.py system

# CPU 정보
python3 final_mcp_server.py cpu

# 메모리 정보
python3 final_mcp_server.py memory

# 모든 정보
python3 final_mcp_server.py all

📁 파일 구조

mcp_pc_info/
├── final_mcp_server.py          # 메인 MCP 서버 (권장)
├── real_mcp_server.py           # 대체 MCP 서버
├── simple_pc_info_server.py     # 간단한 CLI 서버
├── demo_pc_info.py              # 데모 스크립트
├── requirements.txt             # Python 의존성
├── setup_mcp.sh                 # 자동 설정 스크립트
├── README_MCP.md               # 상세한 사용법 문서
└── README.md                   # 이 파일

🔧 문제 해결

권한 오류

일부 정보(네트워크 연결, 특정 프로세스)는 권한 부족으로 접근할 수 없을 수 있습니다. 이는 정상적인 동작입니다.

MCP 연결 실패

  1. Python 경로가 올바른지 확인
  2. psutil 패키지가 설치되어 있는지 확인
  3. Claude Desktop을 재시작

📊 예제 출력

{
  "timestamp": "2025-09-26T13:40:52.497347",
  "system": {
    "platform": "macOS-15.5-arm64-arm-64bit",
    "hostname": "NHNui-MacBookPro.local",
    "architecture": ["64bit", ""]
  },
  "cpu": {
    "cpu_count_physical": 12,
    "cpu_count_logical": 12,
    "cpu_percent": 14.7
  },
  "memory": {
    "total_memory_gb": 48.0,
    "used_memory_gb": 19.05,
    "memory_percent": 67.0
  }
}

🤝 기여하기

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

🙏 감사의 말