MCP Homescan 서버

홈 네트워크 검색 및 보안 스캔을 위한 MCP 서버입니다. 로컬 네트워크의 장치를 검색하고, 제조사를 식별하며, 잠재적인 보안 문제를 표시하고, Obsidian 인벤토리 형식으로 내보냅니다.

왜 이 도구를 사용해야 하나요?

가정이나 소규모 사무실 네트워크를 관리하는 경우, 이 MCP 서버를 통해 다음을 수행할 수 있습니다:

• 모든 장치 검색 - ARP 테이블 스캔을 통해 네트워크에 연결된 모든 장치 찾기

• 제조사 식별 - MAC 주소를 통한 자동 제조사 조회

• 보안 문제 표시 - 알 수 없거나 잠재적으로 위험한 장치(특정 지역의 IoT 등) 식별

• 변경 사항 추적 - 스캔 간에 새로 추가되거나 제거된 장치 감지

• 네트워크 문서화 - Obsidian 또는 기타 문서 시스템을 위한 Markdown으로 내보내기

Related MCP server: Security MCP Server

기능

사전 요구 사항

• Node.js 18+

• macOS 또는 Linux (arp 명령 사용)

• 로컬 서브넷에 대한 네트워크 액세스

설치

npm 사용 (권장)

npx mcp-homescan

또는 전역 설치:

npm install -g mcp-homescan

소스에서 설치

git clone https://github.com/aplaceforallmystuff/mcp-homescan.git
cd mcp-homescan
npm install
npm run build

구성

Claude Desktop용

Claude Desktop 구성 파일에 추가하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "homescan": {
      "command": "npx",
      "args": ["-y", "mcp-homescan"],
      "env": {
        "HOMESCAN_SUBNET": "192.168.1"
      }
    }
  }
}

Claude Code용

~/.claude.json에 추가하세요:

{
  "mcpServers": {
    "homescan": {
      "command": "npx",
      "args": ["-y", "mcp-homescan"],
      "env": {
        "HOMESCAN_SUBNET": "192.168.1"
      }
    }
  }
}

환경 변수

사용 예시

네트워크 검색

"홈 네트워크에서 장치를 스캔해줘"

"내 네트워크에 어떤 장치가 있나요?"

"네트워크 스캔을 새로 고치고 모든 장치를 보여줘"

장치 조사

"192.168.1.34에 있는 장치는 무엇인가요?"

"MAC 주소 aa:bb:cc:dd:ee:ff의 제조사를 찾아줘"

보안 검토

"내 네트워크에서 표시된(flagged) 장치를 보여줘"

"조사해야 할 알 수 없는 장치가 있나요?"

변경 사항 추적

"마지막 스캔 이후 새로 나타난 장치가 있나요?"

"내 네트워크에서 무엇이 변경되었는지 보여줘"

문서화

"네트워크 인벤토리를 markdown으로 내보내줘"

"네트워크 보고서를 생성해줘"

사용 가능한 도구

개발

# Watch mode for development
npm run watch

# Build TypeScript
npm run build

# Run locally
node dist/index.js

문제 해결

"No devices found"

동일한 네트워크 세그먼트에 있는지, 서브넷이 올바르게 구성되었는지 확인하세요. refresh: true 옵션을 사용하여 핑 스윕을 먼저 수행해 보세요.

"Permission denied" 오류

일부 시스템에서는 ARP 테이블에 접근하기 위해 높은 권한이 필요할 수 있습니다. 필요한 경우 sudo를 사용하여 실행해 보세요.

스캔에서 장치가 누락됨

일부 장치는 ARP 쿼리에 응답하지 않을 수 있습니다. refresh: true와 함께 homescan_discover를 사용하여 먼저 네트워크를 핑 스윕하세요.

잘못된 서브넷

네트워크 구성을 확인하고 HOMESCAN_SUBNET을 로컬 네트워크와 일치하도록 업데이트하세요 (일반적인 값: 192.168.1, 192.168.0, 10.0.0).

보안 참고 사항

• 이 도구는 로컬 네트워크만 스캔합니다.

• 외부로 전송되는 데이터는 없습니다.

• 표시된 장치는 권장 사항일 뿐이므로 조치를 취하기 전에 확인하십시오.

• 취약점 공개는 SECURITY.md를 참조하세요.

로드맵

계획된 작업 및 범위 추정치는 ROADMAP.md를 참조하세요.

기여

기여를 환영합니다! 지침은 CONTRIBUTING.md를 참조하세요.

라이선스

MIT - 자세한 내용은 LICENSE를 참조하세요.

링크

• Model Context Protocol

• MCP 사양

• GitHub 저장소