Netops MCP

MCP运维云端

提供方 alpadalar

运维云端 stdio · 本地进程 Token 社区 / 第三方
查看接入方式

提供标准化接口访问网络运维和基础设施工具的全面模型上下文协议(MCP)服务器。

一句话选型结论

按资料字段整理

Netops MCP 属于运维云端类 MCP 服务器,stdio · 本地进程,Token,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

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

工具与能力

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

能力标签

适用场景

网络运维Python本地部署网络工具网络监控HTTP测试DNS工具

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
python -m venv .venv

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后客户端会列出约 19 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

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

值得选的地方

  • 资料标注 19 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Netops MCP当前 19 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

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

详细介绍

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

NetOps MCP-网络操作工具MCP服务器

一个全面的模型上下文协议(MCP)服务器,通过标准化接口提供对基本网络操作和基础设施工具的访问。

🚀 特性

网络连接工具

  • 拼:使用可定制的数据包计数和超时测试主机连接
  • 路由跟踪:使用可配置的最大跳数跟踪网络路径
  • 港铁:使用实时统计数据监视网络路径
  • 远程登录:使用telnet测试端口连接
  • Netcat:使用netcat测试端口连接

HTTP/API测试工具

  • cURL:执行HTTP请求,完全控制标头、方法和数据
  • HTTPie:具有简化语法的替代HTTP客户端
  • API测试:使用预期状态代码验证API终结点

DNS工具

  • 名称服务器查找:查询各种记录类型的DNS记录
  • 挖:高级DNS查询工具
  • 主机:简单DNS查找实用程序

网络发现工具

  • Nmap:网络扫描和服务枚举
  • 端口扫描:目标端口扫描功能
  • 服务发现:识别目标上正在运行的服务

系统监控工具

  • SS:套接字统计和连接监控
  • 网络统计:网络统计和连接信息
  • 地址解析协议:地址解析协议表管理
  • ARP:测试ARP连接

系统信息工具

  • 系统状态:CPU、内存和磁盘使用情况监控
  • 进程列表:正在运行进程枚举
  • 所需工具检查:验证系统工具可用性

📋 先决条件

所需系统工具

系统上必须安装以下工具:```bash

Network tools

curl, ping, traceroute, mtr, telnet, nc (netcat)

DNS tools

nslookup, dig, host

Network discovery

nmap

System tools

ss, netstat, arp, arping

HTTP tools

httpie (optional, for enhanced HTTP testing)


### Python要求

- Python 3.8+
- uv包管理器(推荐)

## 🛠️ 安装

### 使用紫外线(推荐)```bash
# Clone the repository
git clone https://github.com/alpadalar/NetOpsMCP.git
cd NetOpsMCP

# Install dependencies using uv
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

使用pip```bash

Clone the repository

git clone https://github.com/alpadalar/NetOpsMCP.git
cd NetOpsMCP

Create virtual environment

python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate

Install dependencies

pip install -e .


### 使用Docker```bash
# Build and run with Docker Compose
docker compose up -d

# Or build manually
docker build -t netopsmcp .
docker run -p 8815:8815 netopsmcp

🚀 快速开始

1.启动服务器```bash

Using Python directly

python -m netops_mcp.server_http --host 0.0.0.0 --port 8815

Using Docker

docker compose up -d

Using the provided script

./start_http_server.sh


### 2.测试服务器```bash
# Health check
curl http://localhost:8815/health

# Test system requirements
curl -X POST http://localhost:8815/netops-mcp \
-H "Content-Type: application/json" \
-d '{"method": "check_required_tools", "params": {}}'

3.示例用法```python

Ping a host

result = ping_host("google.com", count=4, timeout=10)

Test HTTP endpoint

result = curl_request("https://httpbin.org/get", method="GET")

DNS lookup

result = nslookup_query("google.com", record_type="A")

Network scan

result = nmap_scan("192.168.1.1", ports="1-1000", scan_type="basic")


## 📖 API 参考

### 网络连接

#### `ping_host(host: str, count: int = 4, timeout: int = 10)`

使用ping测试与主机的连接。

**参数:**

- `host`:目标主机名或IP地址
- `count`:ping数据包的数量(默认值:4)
- `timeout`:超时时间(秒)(默认值:10)

**退货:** Ping统计和结果

#### `traceroute_path(target: str, max_hops: int = 30, timeout: int = 30)`

跟踪目标的网络路径。

**参数:**

- `target`:目标主机名或IP地址
- `max_hops`:最大跳数(默认值:30)
- `timeout`:超时时间(秒)(默认值:30)

**退货:** 网络路径信息

#### `mtr_monitor(target: str, count: int = 10, timeout: int = 30)`

使用MTR监控网络路径。

**参数:**

- `target`:目标主机名或IP地址
- `count`:探头数量(默认值:10)
- `timeout`:超时时间(秒)(默认值:30)

**退货:** 港铁统计数据和跳车信息

### HTTP测试

#### `curl_request(url: str, method: str = "GET", headers: dict = None, data: dict = None, timeout: int = 30)`

使用curl执行HTTP请求。

**参数:**

- `url`:目标URL
- `method`:HTTP方法(GET、POST、PUT、DELETE、PATCH)
- `headers`:HTTP标头字典
- `data`:请求POST/PUT请求的数据
- `timeout`:请求超时(秒)

**退货:** HTTP响应和定时信息

#### `httpie_request(url: str, method: str = "GET", headers: dict = None, data: dict = None, timeout: int = 30)`

使用HTTPie执行HTTP请求。

**参数:** 与curl_request相同

**退货:** HTTP响应和定时信息

### DNS工具

#### `nslookup_query(domain: str, record_type: str = "A", server: str = None)`

使用nslookup查询DNS记录。

**参数:**

- `domain`:目标域名
- `record_type`:DNS记录类型(A、AAAA、MX、NS、TXT、CNAME)
- `server`:自定义DNS服务器(可选)

**退货:** DNS查询结果

#### `dig_query(domain: str, record_type: str = "A", server: str = None)`

使用dig查询DNS记录。

**参数:** 与nslookup_query相同

**退货:** 详细的DNS查询结果

### 网络发现

#### `nmap_scan(target: str, ports: str = None, scan_type: str = "basic", timeout: int = 300)`

使用nmap扫描网络。

**参数:**

- `target`:目标主机名、IP或网络范围
- `ports`:端口范围(例如,“1-1000”、“804438080”)
- `scan_type`:扫描类型(基本、完整、隐形)
- `timeout`:扫描超时(秒)

**退货:** 网络扫描结果

#### `port_scan(target: str, ports: str, timeout: int = 60)`

执行目标端口扫描。

**参数:**

- `target`:目标主机名或IP地址
- `ports`:要扫描的端口范围
- `timeout`:扫描超时(秒)

**退货:** 端口扫描结果

### 系统监控

#### `system_status()`

获取系统状态信息。

**退货:** CPU、内存和磁盘使用统计信息

#### `ss_connections(state: str = None, protocol: str = None)`

使用ss显示网络连接。

**参数:**

- `state`:按连接状态筛选
- `protocol`:按协议筛选

**退货:** 网络连接信息

#### `netstat_connections(state: str = None, protocol: str = None)`

使用netstat显示网络连接。

**参数:** 与ss_connections相同

**退货:** 网络连接信息

## 🧪 测试

### 运行所有测试```bash
# Using pytest
pytest tests/ -v

# Using uv
uv run pytest tests/ -v

# With coverage
pytest tests/ --cov=src --cov-report=html --cov-report=term-missing

测试类别

  • 单元测试:单个工具功能
  • 集成测试:端到端工作流测试
  • 模拟测试:命令执行模拟
  • 验证测试:输入验证和错误处理

测试覆盖率

测试套件包括:

  • ✅ 所有工具方法和功能
  • ✅ 输入验证和错误处理
  • ✅ 命令执行和输出解析
  • ✅ 边缘情况和错误场景
  • ✅ 外部依赖关系的模拟测试

要生成覆盖率报告,请执行以下操作:```bash

Generate HTML coverage report

pytest tests/ --cov=src --cov-report=html

Generate terminal coverage report

pytest tests/ --cov=src --cov-report=term-missing

Generate both reports

pytest tests/ --cov=src --cov-report=html --cov-report=term-missing


## 🔧 配置

### 环境变量```bash
# Server configuration
NETOPS_MCP_HOST=0.0.0.0
NETOPS_MCP_PORT=8815
NETOPS_MCP_LOG_LEVEL=INFO

# Tool timeouts
PING_TIMEOUT=10
TRACEROUTE_TIMEOUT=30
MTR_TIMEOUT=30
CURL_TIMEOUT=30
NMAP_TIMEOUT=300

配置文件

服务器将从以下位置自动创建默认配置文件 config/config.example.json 第一次运行时,或者您可以创建 config/config.json 手动:```json
{
"logging": {
"level": "INFO",
"format": "%(asctime)s - %(name)s - %(levelname)s - %(message)s",
"file": "logs/netops-mcp.log"
},
"security": {
"allow_privileged_commands": false,
"allowed_hosts": [],
"rate_limit_requests": 100,
"rate_limit_window": 60
},
"network": {
"default_timeout": 30,
"max_scan_timeout": 300,
"allowed_ports": "1-65535"
},
"server": {
"host": "0.0.0.0",
"port": 8815,
"path": "/netops-mcp"
}
}


## 🐳 Docker支持

### Docker Compose```yaml
version: '3.8'
services:
netopsmcp:
build: .
ports:
- "8815:8815"
environment:
- NETOPS_MCP_HOST=0.0.0.0
- NETOPS_MCP_PORT=8815
volumes:
- ./logs:/app/logs
- ./config:/app/config
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8815/health"]
interval: 30s
timeout: 10s
retries: 3

Docker构建```bash

Build image

docker build -t netopsmcp .

Run container

docker run -d \
--name netopsmcp \
-p 8815:8815 \
-v $(pwd)/logs:/app/logs \
-v $(pwd)/config:/app/config \
netopsmcp


## 📊 监控和日志记录

### 日志级别

- **调试**:详细的调试信息
- **信息**:一般操作信息
- **警告**:潜在问题的警告信息
- **错误**:失败操作的错误消息

### 日志文件

- `logs/netops-mcp.log`:主应用程序日志
- `logs/access.log`:HTTP访问日志
- `logs/error.log`:错误日志

### 健康检查```bash
# Check server health
curl http://localhost:8815/health

# Check system requirements
curl -X POST http://localhost:8815/netops-mcp \
-H "Content-Type: application/json" \
-d '{"method": "check_required_tools", "params": {}}'

🔒 安全注意事项

网络安全

  • 防火墙规则:为服务器端口配置适当的防火墙规则
  • 访问控制:必要时实施身份验证
  • 网络隔离:尽可能在隔离的网络环境中运行

工具安全

  • 特权操作:某些工具需要提升权限
  • 网络扫描:了解网络扫描的法律影响
  • 速率限制:对资源密集型业务实施费率限制

最佳实践

  • 输入验证:所有输入在处理前都经过验证
  • 错误处理:全面的错误处理和记录
  • 超时管理:所有操作的可配置超时
  • 资源限制:内置资源使用限制

🚀 生产部署

快速生产设置

  1. 生成API密钥:```bash
    python scripts/generate_api_key.py -n 2 --config config/config.json

1. **配置安全** (`config/config.json`):```json
{
"security": {
"require_auth": true,
"api_keys": ["your-generated-key-here"],
"rate_limit_requests": 100,
"rate_limit_window": 60
}
}
  1. 使用Docker Compose进行部署:```bash
    docker compose up -d

1. **验证部署**:```bash
curl http://localhost:8815/health

认证

服务器支持API密钥身份验证以实现安全访问:```bash

Make authenticated request

curl -X POST http://localhost:8815/netops-mcp \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"method": "ping_host", "params": {"host": "google.com"}}'


### HTTPS设置(推荐)

使用反向代理(nginx或Caddy)进行HTTPS:```nginx
server {
listen 443 ssl http2;
server_name your-domain.com;

ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;

location / {
proxy_pass http://localhost:8815;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}

生产特点

  • ✅ API密钥验证:使用Bearer令牌进行安全访问控制
  • ✅ 速率限制:内置速率限制(默认为100要求/分钟)
  • ✅ 输入验证:全面的输入净化
  • ✅ 结构化日志记录:用于生产环境的JSON日志记录
  • ✅ 健康检查:内置健康检查端点
  • ✅ Docker支持:具有多阶段构建的生产就绪Docker映像
  • ✅ 非root用户:在容器中以无特权用户身份运行
  • ✅ 资源限制:可配置的CPU和内存限制
  • ✅ CORS支持:可配置的web应用程序CORS
  • ✅ 安全标头:自动安全标头

CI/CD管道

GitHub操作工作流包括:

  • 测试:Python 3.10、3.11、3.12的自动测试
  • 代码检查:代码质量检查(黑色、Ruff、mypy)
  • 安全:安全扫描(Bandit、Safety、Trivy)
  • 发布:自动将Docker镜像发布到GitHub容器注册表

文档

  • 📖 生产部署指南
  • 🔐 API身份验证指南
  • 🛡️ 安全策略

🤝 贡献

开发设置```bash

Clone repository

git clone https://github.com/alpadalar/NetOpsMCP.git
cd NetOpsMCP

Install development dependencies

uv pip install -e .

Run tests

pytest tests/ -v
```

代码风格

  • 黑色:代码格式
  • 拉夫:梳理和进口分拣
  • 米皮:类型检查

测试指南

  • 为所有新功能编写测试
  • 保持测试覆盖率在90%以上
  • 使用有意义的测试名称和描述
  • 模拟外部依赖关系

拉取请求流程

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 添加新功能的测试
  5. 更新文档
  6. 提交拉取请求

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🆘 支持

文档

  • API参考:参见上文API参考部分
  • 配置指南:请参阅上面的配置部分
  • 故障排除:请参阅上面的支持部分

问题

  • 错误报告:使用GitHub问题
  • 功能请求:通过GitHub提交问题
  • 安全问题:直接联系维护人员

社区

  • 问题:GitHub用于讨论和提问的问题
  • 文档:有关综合指南,请参阅上述章节

🙏 致谢

  • MCP协议:模型上下文协议规范
  • 网络工具:开源网络实用程序
  • 测试框架:pytest和相关工具
  • 社区:贡献者和用户

网络运营MCP -通过标准化的工具访问授权网络运营。

托管部署

托管部署可在 Frontier AI.

常见问题

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

在客户端按下面的安装命令接入:python -m venv .venv。装完在客户端配置里引用同一个包或端点。

Netops MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Netops MCP 收费吗?

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

Netops MCP 需要 API Key 吗?

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

Netops MCP 能提供哪些能力?

资料显示约 19 个工具;能力标签包括 网络工具、Python、网络监控。具体工具清单以官方文档为准。

Netops MCP 需要什么运行环境?

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

Netops MCP 是本地还是远程?

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

热门专题

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

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