MCP家庭扫描服务器
](https://www.npmjs.com/package/mcp-homescan)   
用于家庭网络发现和安全扫描的MCP服务器。发现本地网络上的设备，识别制造商，标记潜在的安全问题，并导出为黑曜石库存格式。
为什么使用这个？
如果您正在管理家庭或小型办公室网络，此MCP服务器可以让您：
- 发现所有设备 -通过ARP表扫描查找连接到网络的所有内容
- 确定制造商 -自动查找制造商的MAC地址
- 标记安全问题 -识别未知或潜在风险的设备（来自某些地区的物联网等）
- 跟踪更改 -在扫描之间检测新的或删除的设备
- 记录您的网络 -导出到黑曜石或其他文档系统的markdown
特性
| 类别 | 功能 |
|---|---|
| 发现 | 基于ARP的网络扫描、ping扫描，实现全面发现 |
| 识别 | MAC地址制造商查找、设备分类 |
| 安全 | 标记未知设备，识别潜在的物联网风险 |
| 变化检测 | 比较扫描结果，跟踪新/删除的设备 |
| 出口 | Markdown和JSON格式，兼容黑曜石的库存 |
先决条件
- 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配置文件中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"homescan": {
"command": "npx",
"args": ["-y", "mcp-homescan"],
"env": {
"HOMESCAN_SUBNET": "192.168.1"
}
}
}
}克劳德代码
添加 ~/.claude.json:
{
"mcpServers": {
"homescan": {
"command": "npx",
"args": ["-y", "mcp-homescan"],
"env": {
"HOMESCAN_SUBNET": "192.168.1"
}
}
}
}环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
HOMESCAN_SUBNET | 要扫描的网络子网（例如。， 192.168.1) | 192.168.1 |
使用示例
网络发现
“扫描我的家庭网络以查找设备”
“我的网络上有哪些设备？”
“刷新网络扫描并显示所有设备”
设备调查
“192.168.1.34上的设备是什么？”
“查找制造商的MAC地址aa:bb:cc:dd:ee:ff”
安全审查
“在我的网络上显示任何标记的设备”
“有什么我应该调查的未知设备吗？”
更改跟踪
“自上次扫描以来，是否出现了任何新设备？”
“显示我的网络上发生了什么变化”
文档
“将我的网络库存导出到markdown”
“生成网络报告”
可用工具
| 工具 | 说明 |
|---|---|
homescan_discover | 发现本地网络上的所有设备 |
homescan_device | 按IP获取特定设备的详细信息 |
homescan_mac_lookup | 从MAC地址查找制造商 |
homescan_report | 生成全面的网络发现报告 |
homescan_export | 将设备导出为markdown或JSON格式 |
homescan_diff | 将当前扫描与之前的扫描进行比较，显示更改 |
homescan_flagged | 列出标记为进行安全审查的设备 |
发展
# Watch mode for development
npm run watch
# Build TypeScript
npm run build
# Run locally
node dist/index.js故障排除
“未找到设备”
确保您位于同一网段，并且子网配置正确。试着用 refresh: true 首先执行ping扫描。
“权限被拒绝”错误
ARP表在某些系统上可能需要提升权限。试着用 sudo 如果需要的话。
扫描中缺少设备
某些设备可能不会响应ARP查询。使用 homescan_discover 随着 refresh: true ping命令首先扫描网络。
子网错误
检查您的网络配置并更新 HOMESCAN_SUBNET 以匹配您的本地网络（常见值： 192.168.1, 192.168.0, 10.0.0).
安全说明
- 此工具仅扫描您的本地网络
- 不向外部发送数据
- 标记的设备仅供参考——在采取行动之前进行验证
- 看 安全.md 用于漏洞披露
路线图
看 ROADMAP.md 用于计划工作和范围估算。
贡献
欢迎投稿！请参阅 贡献.md 作为指导方针。
许可证
麻省理工学院-见 许可证 了解详情。
链接
-