Network Scanner

MCP安全风控

提供方 bryankemp

安全风控 stdio · 本地进程 会话登录 社区 / 第三方 Claude
查看接入方式

一个全面的网络扫描和管理解决方案,提供现代Web界面、RESTful API和通过模型上下文协议(MCP)的AI集成。

一句话选型结论

按资料字段整理

Network Scanner 属于安全风控类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类安全风控 传输方式stdio · 本地进程 鉴权会话登录 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

安全风控
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

网络扫描Python本地部署服务发现网络拓扑AI集成网络管理

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
python3 setup.py dev

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
资产与漏洞排查

盘点资产、扫漏洞、看暴露面。

日志与审计

汇总日志、查异常行为。

合规检查

按规则检查配置与权限是否合规。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在安全风控场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Network Scanner当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Cyber Strike AI 75 未标注 未标注 无 2026-05-17
mcp-for-beginners 未标注 stdio · 本地进程 本地部署 有 2026-04-13
casdoor 未标注 stdio · 本地进程 本地部署 有 2026-04-12
kubeshark 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Modelcontextprotocol C22988b0 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

安全风控
字段来自项目仓库与公开索引,中文说明由本站标注
提供方bryankemp上游标注的维护方 bryankemp
分类安全风控本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.0 KB
来自项目仓库与上游目录的原文,未做删改

局域网扫描工具

一个全面的网络扫描和管理解决方案,具有现代web界面、RESTful API和通过模型上下文协议(MCP)的人工智能集成。

作者 布莱恩·肯普 \
许可证: BSD 3-条款\
版本: 1.0.0

📋 目录

  • 特性
  • 快速开始
  • 安装
  • 建筑
  • 用法
  • API 文档
  • MCP集成
  • 发展
  • 测试
  • 部署
  • 容器注册表
  • 故障排除

✨ 特性

核心扫描功能

  • 🔍 并行网络扫描 -高效的多网络CIDR扫描
  • 🖥️ 虚拟机检测 -自动识别虚拟机和容器
  • 🔐 服务发现 -具有服务/版本检测功能的全面端口扫描
  • 🌐 网络拓扑 -追踪路线映射和可视化
  • 📊 操作系统识别 -操作系统检测,精度评分

计划扫描

  • ⏰ 基于Cron的时间表 -使用灵活的cron表达式创建重复扫描
  • 📅 预配置预设 -常见时间表(每小时、每天、每周等)
  • 🔄 手动触发 -按需执行预定扫描

报告和可视化

  • 📄 HTML报告 -详细、风格化的网络扫描报告
  • 📊 Excel导出 -XLSX格式的结构化数据
  • 🗺️ 将网络图 -自动生成的拓扑图(PNG/SVG)

web界面

  • 🎨 现代Flutter用户界面 -响应式材料设计3界面
  • 📱 移动就绪 -适用于台式机、平板电脑和移动设备
  • 🌓 暗/亮主题 -自动切换主题
  • 🔒 基于角色的访问 -管理员和用户角色
  • 🔐 JWT认证 -基于安全令牌的身份验证

人工智能集成(MCP)

  • 🤖 Claude/Warp人工智能集成 -使用自然语言查询扫描数据
  • 💬 会话查询 -“显示所有虚拟机”或“192.168.1.10上正在运行哪些服务?”
  • 📈 网络统计 -通过AI助手获得见解

🚀 快速开始

自动设置(推荐)```bash

Clone the repository

git clone https://github.com/yourusername/network-scan.git
cd network-scan

Set up development environment

python3 setup.py dev

Run tests

python3 setup.py test

Start the backend server

cd backend
source venv/bin/activate
uvicorn app.main:app --reload


API将于 `http://localhost:8000`\
API文件,网址: `http://localhost:8000/docs`

### Docker设置```bash
# Build and run
python3 setup.py docker

# Or use docker-compose
docker-compose up -d

服务安装```bash

Install as system service (macOS/Linux)

python3 setup.py service


## 📦 安装

### 先决条件

**必修的:**

- Python 3.8+
- nmap

**可选:**

- Flutter 3.9+(用于web UI)
- Docker(用于容器)
- Graphviz(用于图表)

### 手动安装```bash
# Backend
cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# Frontend (optional)
cd frontend
flutter pub get

# MCP Server
cd mcp_server
pip install -r requirements.txt

🏗️ 建筑```

network-scan/
├── backend/ # FastAPI REST API
├── frontend/ # Flutter web app
├── mcp_server/ # AI integration
├── tests/ # Test suite
├── setup.py # Setup automation
└── run_tests.py # Test runner


**技术栈:** FastAPI、Flutter、SQLite、nmap、MCP

## 💻 用法

### API示例```bash
# Create scan
curl -X POST http://localhost:8000/api/scans \
-H "Content-Type: application/json" \
-d '{"network_range": ["192.168.1.0/24"]}'

# Get scan details
curl http://localhost:8000/api/scans/1

# Download reports
curl http://localhost:8000/api/scans/1/artifacts/html -o report.html
curl http://localhost:8000/api/scans/1/artifacts/xlsx -o report.xlsx

web界面

导航至 http://localhost:8000

默认凭据:

  • 用户名: admin
  • 密码: Admin123!
  • ⚠️ 首次登录时更改!

📚 API 文档

交互式文档: http://localhost:8000/docs

关键终点

  • POST /api/scans -创建扫描
  • GET /api/scans -列表扫描
  • POST /api/schedules -创建日程表
  • GET /api/hosts/unique -最新主机数据
  • GET /api/stats -网络统计
  • POST /api/auth/login -身份验证

🤖 MCP集成

可用工具

  • list_scans -列出所有扫描
  • query_hosts -搜索主机
  • get_host_services -获取主机服务
  • get_network_stats -网络统计
  • list_vms -列出虚拟机/容器
  • search_service -在网络上查找服务

配置

克劳德桌面: ~/Library/Application Support/Claude/claude_desktop_config.json
扭曲AI: `~/.warp/mcp_config.json````json
{
"mcpServers": {
"network-scanner": {
"command": "python3",
"args": ["/path/to/network-scan/mcp_server/server.py"],
"env": {
"DATABASE_PATH": "/path/to/network-scan/network_scanner.db"
}
}
}
}


## 🛠️ 发展```bash
# Run with auto-reload
cd backend
source venv/bin/activate
uvicorn app.main:app --reload

# Code quality
black backend/ --line-length 100
ruff check backend/

# Tests
python3 setup.py test

🧪 测试

总计:92次测试 (33个后端,38个MCP,21个前端)```bash

All tests

python3 setup.py test

Individual components

cd backend && pytest tests/ -v
cd mcp_server && pytest test_mcp_server.py -v
cd frontend && flutter test


## 🚀 部署

### 使用GitHub容器注册表中的预构建容器

运行Network Scanner最简单的方法是使用预构建的容器映像:```bash
# Pull the latest image
docker pull ghcr.io/bryank/network-scan:latest

# Run the container
docker run -d \
--name network-scan \
--cap-add NET_RAW \
--cap-add NET_ADMIN \
-p 8000:8000 \
-p 8001:8001 \
-v $(pwd)/data/scan_outputs:/app/scan_outputs \
-v $(pwd)/data/database:/app/database \
ghcr.io/bryank/network-scan:latest

使用docker与GHCR组合:

创建 docker-compose.ghcr.yml:```yaml
services:
network-scan:
container_name: network-scan
image: ghcr.io/bryank/network-scan:latest
ports:
- "8000:8000"
- "8001:8001"
environment:
- PYTHONUNBUFFERED=1
- TZ=America/Chicago
volumes:
- ./data/scan_outputs:/app/scan_outputs
- ./data/database:/app/database
cap_add:
- NET_RAW
- NET_ADMIN
restart: unless-stopped
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8000/health"]
interval: 30s
timeout: 10s
retries: 3
start_period: 40s


然后运行:```bash
docker-compose -f docker-compose.ghcr.yml up -d

可用标签:

  • latest -最新稳定版本
  • v1.0.0 -具体版本
  • main -主分行最新消息

从源头构建```bash

python3 setup.py docker
docker-compose -f docker-compose.production.yml up -d


## 📦 容器注册表

有关使用GitHub容器注册表、构建多架构映像和发布工作流的详细信息,请参阅:

👉 **CONTAINER_REGISTRY.md** -完整的容器注册表指南

涵盖的关键主题:

- 提取并运行预构建的图像
- 私有注册表的身份验证
- 多架构支持(amd64、arm64)
- GitHub操作自动化
- 标记策略和最佳实践

### 系统服务```bash
python3 setup.py service

# Manage service
# macOS: launchctl list | grep network-scanner
# Linux: sudo systemctl status network-scanner

环境变量

创建 backend/.env:```bash
SECRET_KEY=your-secret-key-here
DEBUG=False
SCAN_PARALLELISM=8


## 🔧 故障排除

**未找到nmap**```bash
# macOS
brew install nmap

# Linux
sudo apt-get install nmap

权限不足```bash

Linux: Grant nmap capabilities

sudo setcap cap_net_raw,cap_net_admin+eip $(which nmap)


**集装箱许可问题**

如果容器无法扫描,请确保容器具有所需的功能:```bash
docker run --cap-add NET_RAW --cap-add NET_ADMIN ...

容器图像身份验证

对于私人注册或限速:```bash

GitHub Container Registry

echo $GITHUB_TOKEN | docker login ghcr.io -u USERNAME --password-stdin

Then pull

docker pull ghcr.io/bryank/network-scan:latest
```

数据库锁

为了实现高并发性,请使用PostgreSQL而不是SQLite。

📄 许可证

BSD 3条款许可证-请参阅 许可证 文件

📞 支持

  • 电子邮件: bryan@kempville.com
  • 问题: GitHub问题

由以下材料制成❤️ 作者:布莱恩·肯普

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Network Scanner 怎么安装?

在客户端按下面的安装命令接入:python3 setup.py dev。装完在客户端配置里引用同一个包或端点。

Network Scanner 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Network Scanner 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Network Scanner 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Network Scanner 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Network Scanner 能提供哪些能力?

资料显示能力标签包括 Python、Claude、网络管理。具体工具清单以官方文档为准。

Network Scanner 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Network Scanner 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。