MCP Homescan Server

ホームネットワークの探索とセキュリティスキャンを行うための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 のメーカーを調べて"

セキュリティレビュー

"ネットワーク上でフラグが立てられたデバイスを表示して"

"調査すべき未知のデバイスはありますか？"

変更追跡

"前回のスキャン以降、新しいデバイスは現れましたか？"

"ネットワーク上で何が変更されたか教えて"

ドキュメント化

"ネットワークインベントリをMarkdownにエクスポートして"

"ネットワークレポートを生成して"

利用可能なツール

開発

# Watch mode for development
npm run watch

# Build TypeScript
npm run build

# Run locally
node dist/index.js

トラブルシューティング

"No devices found"

同じネットワークセグメントにいること、およびサブネットが正しく設定されていることを確認してください。最初にpingスイープを実行するために refresh: true を指定して実行してみてください。

"Permission denied" エラー

一部のシステムでは、ARPテーブルへのアクセスに昇格された権限が必要な場合があります。必要に応じて sudo を付けて実行してみてください。

スキャンにデバイスが表示されない

一部のデバイスはARPクエリに応答しない場合があります。最初にネットワークをpingスイープするために 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 Specification

• GitHub Repository