MCP Homescan Server

用于家庭网络发现和安全扫描的 MCP 服务器。它可以发现本地网络上的设备、识别制造商、标记潜在的安全问题，并导出为 Obsidian 清单格式。

为什么要使用它？

如果您正在管理家庭或小型办公室网络，此 MCP 服务器可以让您：

• 发现所有设备 - 通过 ARP 表扫描查找连接到您网络的所有设备

• 识别制造商 - 自动进行 MAC 地址到制造商的查找

• 标记安全问题 - 识别未知或潜在风险设备（如来自特定地区的物联网设备等）

• 跟踪变化 - 检测两次扫描之间新增或移除的设备

• 记录您的网络 - 导出为 Markdown 以供 Obsidian 或其他文档系统使用

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"
      }
    }
  }
}

环境变量

使用示例

网络发现

"Scan my home network for devices"

"What devices are on my network?"

"Refresh the network scan and show all devices"

设备调查

"What's the device at 192.168.1.34?"

"Look up the manufacturer for MAC address aa:bb:cc:dd:ee:ff"

安全审查

"Show me any flagged devices on my network"

"Are there any unknown devices I should investigate?"

变化跟踪

"Have any new devices appeared since the last scan?"

"Show me what's changed on my network"

文档记录

"Export my network inventory to markdown"

"Generate a network report"

可用工具

开发

# Watch mode for development
npm run watch

# Build TypeScript
npm run build

# Run locally
node dist/index.js

故障排除

"No devices found"

确保您处于同一网段，并且子网配置正确。尝试使用 refresh: true 运行以先执行 Ping 扫描。

"Permission denied" 错误

在某些系统上，ARP 表可能需要提升权限。如果需要，请尝试使用 sudo 运行。

扫描中缺少设备

某些设备可能不会响应 ARP 查询。请使用 refresh: true 运行 homescan_discover 以先对网络进行 Ping 扫描。

子网错误

检查您的网络配置并更新 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