Git Netai

MCPAI代理

提供方 angoran

AI代理 stdio · 本地进程 Token 社区 / 第三方 Claude DesktopClaude
查看接入方式

异步MCP服务器,用于统一管理多平台网络基础设施,通过统一API暴露网络设备、WiFi控制器、监控系统和数据中心。

一句话选型结论

按资料字段整理

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

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

工具与能力

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

能力标签

支持客户端

适用场景

网络管理Python本地部署异步架构多平台支持自动化运维AI助手

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
uv run python -c "from server import mcp; print(f'{mcp.name} operational')"

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

  1. 1
    准备运行环境

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

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

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

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

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

值得选的地方

  • 资料标注 10 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Git Netai当前 10 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

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

详细介绍

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

网络AI助手

用于统一多平台网络基础设施管理的异步MCP(模型上下文协议)服务器。

通过Claude Desktop、Warp AI和任何MCP兼容客户端可访问的统一API,展示网络设备、WiFi控制器、监控系统和数据中心。


主要特点

100%异步架构

  • 异步/等待引擎:所有I/O操作都有杠杆作用 asyncio, asyncssh,以及 httpx 为了获得最佳性能
  • 并行执行:本机支持具有超时保护的多设备操作
  • 持续会话:具有keepalive的可重用HTTP连接,以最大限度地减少延迟
  • 智能JWT缓存:具有自动续订功能的线程安全身份验证令牌管理

10个专用连接器

连接器 类型 MCP工具 说明
通用SSH SSH 2 对任何SSH设备(Cisco、Juniper、Arista、Linux等)的通用CLI访问
MikroTik休息 REST API 9 通过REST API完成管理(接口、BGP、路由、系统健康)
MikroTik SSH SSH 2 REST中不可用的特定命令(路由检查、自定义命令)
帕洛阿尔托SSH SSH PTY 2 PAN-OS防火墙,带PTY交互会话(VPN、路由、系统)
帕洛阿尔托全景 REST API 16 全景式集中管理(设备、设备组、安全规则、合规性、审核)
阿鲁巴WiFi REST API 9 WiFi控制器(AP、客户端、流氓、RF、WLAN、统计数据)
Graylog REST API 3 使用时间筛选器和流式处理的集中式日志搜索
自由 REST API 10 网络监控(库存、运行状况、端口、传感器、事件)
思科APIC(ACI) REST API 28 ACI数据中心(结构、租户、EPG、VRF、合同、拓扑结构、分析)
思科NDFC REST API 14 Nexus Dashboard结构控制器(结构、交换机、网络、VRF、事件)

总计:97个MCP工具 (95个连接器+2个技能工具)


安装

先决条件

  • Python 3.12或更高版本
  • 紫外线 包管理器
  • Dotenx 用于加密凭据(brew install dotenvx/brew/dotenvx)
  • 对目标设备/API的网络访问
  • MCP客户端(克劳德桌面、Warp AI等)

使用UV进行安装```bash

Clone the repository

git clone https://github.com/angoran/git-netai.git
cd git-netai

Sync dependencies (UV automatically creates virtual environment)

uv sync

Verify installation

uv run python -c "from server import mcp; print(f'{mcp.name} operational')"


______________________________________________________________________

## 配置

### 环境变量

创建一个 `.env` 项目根目录下的文件,包含以下变量:```bash
# Generic SSH
SSH_USERNAME="admin"
SSH_PASSWORD="your_password"

# MikroTik REST API
MIKROTIK_USERNAME="api_user"
MIKROTIK_PASSWORD="api_password"
MIKROTIK_PORT="443"

# MikroTik SSH (if different from REST)
MIKROTIK_SSH_USERNAME="ssh_user"
MIKROTIK_SSH_PASSWORD="ssh_password"
MIKROTIK_SSH_PORT="22"

# Palo Alto Firewalls
PALOALTO_SSH_USERNAME="admin"
PALOALTO_SSH_PASSWORD="firewall_password"

# Aruba WiFi Controller
ARUBA_IP="10.x.x.x"
ARUBA_USERNAME="admin"
ARUBA_PASSWORD="aruba_password"

# Graylog
GRAYLOG_API_URL="https://graylog.example.com"
GRAYLOG_USERNAME="graylog_user"
GRAYLOG_PASSWORD="graylog_password"

# LibreNMS
LIBRENMS_URL="https://librenms.example.com"
LIBRENMS_API_TOKEN="your_api_token_here"

# Cisco APIC (ACI)
APIC_HOST="https://apic.example.com"
APIC_USERNAME="apic_user"
APIC_PASSWORD="apic_password"
APIC_VERIFY_SSL="false"
APIC_TIMEOUT="30"
APIC_TOKEN_CACHE_DURATION="3540"

# Cisco NDFC
NDFC_HOST="https://ndfc.example.com"
NDFC_USER="ndfc_user"
NDFC_PASSWORD="ndfc_password"
NDFC_DOMAIN="DefaultAuth"
NDFC_VERIFY_SSL="false"
NDFC_TIMEOUT="30"

# Palo Alto Panorama
PANORAMA_URL="https://panorama.example.com/api"
PANORAMA_USERNAME="panorama_user"
PANORAMA_PASSWORD="panorama_password"
PANORAMA_TIMEOUT="30"

安全说明:凭据使用加密方式存储 DotenxThe .env 该文件包含AES-256-GCM加密值。私钥存储在 .env.keys (不包括在版本控制中)。永不承诺 .env.keys 到存储库。

加密凭据

填写您的 .env 文件,用dotenvx加密:```bash

Encrypt all values in .env (generates .env.keys with the private key)

dotenvx encrypt

Verify decryption works correctly

dotenvx run -- uv run python -c "from server import mcp; print(f'{mcp.name} operational')"


保持 `.env.keys` 保护并通过安全通道(密码管理器、秘密库)将其分发给其他用户。加密的 `.env` 可以安全地共享或提交给版本控制。

______________________________________________________________________

## MCP客户端配置

### 克劳德桌面版

**配置文件位置:**

- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- 窗户: `%APPDATA%\Claude\claude_desktop_config.json`
- Linux: `~/.config/Claude/claude_desktop_config.json````json
{
"mcpServers": {
"netai-o": {
"command": "dotenvx",
"args": [
"run",
"--env-file", "/absolute/path/to/netai/.env",
"--",
"uv",
"--directory", "/absolute/path/to/netai",
"run",
"python",
"server.py"
],
"env": {
"DOTENV_PRIVATE_KEY": ""
}
}
}
}

扭曲AI

配置文件: `~/.warp/mcp_config.json````json
{
"mcpServers": {
"netai-o": {
"command": "dotenvx",
"args": ["run", "--", "uv", "run", "python", "server.py"],
"env": {
"DOTENV_PRIVATE_KEY": ""
},
"working_directory": "/absolute/path/to/netai"
}
}
}


______________________________________________________________________

## 用法

### 启动服务器```bash
# Launch MCP server in stdio mode (with encrypted .env decryption)
dotenvx run -- uv run python server.py

服务器通过stdio协议公开所有MCP工具。MCP客户端(Claude Desktop、Warp)根据其配置文件自动启动服务器。

示例命令

以下示例演示了可用于Claude Desktop或Warp AI的自然语言命令:

通用SSH操作```

Execute "show version" on device 192.168.1.1
Run "show ip route" on devices 192.168.1.1 and 192.168.1.2 in parallel


#### MikroTik管理```
Show BGP sessions on MikroTik router 10.0.0.1
Check route to 8.8.8.8 on MikroTik 10.0.0.1 via SSH
Display interface statistics for 10.0.0.1

Palo Alto防火墙操作```

Show VPN status on Palo Alto firewall 10.240.203.241
Execute "show system info" on firewalls 10.240.203.241 and 10.240.203.242 in parallel
Display routing table on firewall 10.240.203.241


#### Aruba WiFi控制器```
List all access points on Aruba controller
Show connected WiFi clients
Detect rogue access points
Display RF channel utilization
Show WLAN configuration

Graylog日志管理```

Search for "authentication failure" in logs from the last 2 hours
List available Graylog streams
Show system overview and statistics


#### LibreNMS网络监控```
Show all monitored MikroTik devices
Display health metrics for device router-core-01
List all ports on switch-distro-01
Show temperature sensors for all devices
Retrieve event logs for the last 24 hours

思科APIC(ACI数据中心)```

Show overall ACI fabric health
List all APIC tenants
Search for endpoint with IP address 10.1.1.50
Analyze connectivity between EPG web and EPG database
Show top talkers in Production tenant
Display fabric topology
List all contracts in tenant Production


#### 思科NDFC```
List all NDFC fabrics
Show switches in fabric DC1
Get critical events from the last 24 hours
Show interface details for switch with serial FDO23460MQC
Display VRFs in fabric DC1
Show network deployment status

帕洛阿尔托全景```

Show Panorama system information
List all managed firewalls
Show device groups and their members
Analyze security rules quality for device-group Production
Find rules without security profile in device-group DMZ
Check version compliance across all firewalls
Show configuration audit logs
Find duplicate address objects
Show pending configuration changes


#### 技能(指导工作流程)

调用技能的推荐方法是明确指示代理加载并遵循它:```
Load and execute the skill "infrastructure-health-check".
Follow every step of the procedure in order and produce a structured report.
``````
Use skills_list to find the most appropriate skill, then load it with skills_load
and execute it step by step.
Task: BGP sessions on router 10.0.0.1 are flapping since this morning.
``````
# Discovery and filtering
List all available skills
List skills for platform ACI
List skills tagged with "change-management"

# Monitoring and NOC
Run an infrastructure health check across all platforms
Perform a WiFi health monitoring report on the Aruba controller
Do a deep dive on device router-wan-01

# Troubleshooting
Diagnose BGP on MikroTik router 10.0.0.1
Track endpoint with IP 10.1.2.50 in the ACI fabric
Run a full ACI fabric health diagnostic
Check connectivity between device A and device B

# Compliance and Audit
Run a Panorama security audit on device-group Production
Check software version compliance and certificate expiry across all firewalls
Audit the ACI configuration for tenant Prod

# Change Management
Perform a pre-check before the maintenance window for change CHG0012345
Validate the post-change state and compare with the pre-check baseline
Detect any unauthorized configuration changes in the last 48 hours

# Inventory and Capacity
Generate a consolidated multi-vendor inventory
Map the physical network topology using LLDP discovery
Produce a capacity planning report for the infrastructure

# Incident Response
Correlate events and logs to identify the root cause of the incident
reported at 14:30 UTC — application servers cannot reach the database

技能是Markdown中一步一步的操作过程。LLM电话 skills_list() 要发现按平台或标签筛选的可用程序,则 skills_load() 检索完整的过程,并按照顺序调用引用的MCP工具。每项技能都包括一个决策矩阵、企业级报告的输出标准和一个包含运营最佳实践的注释部分。


技术架构

项目结构```

git-netai/
├── server.py # MCP entry point (FastMCP stdio transport)
├── skills_engine.py # Skills index + loader (in-memory, YAML frontmatter)
├── connectors/ # Asynchronous connector modules
│ ├── ssh_c.py # Generic SSH connector (asyncssh)
│ ├── mikrotik_c.py # MikroTik REST API connector (httpx)
│ ├── mikrotik_ssh_c.py # MikroTik SSH connector (asyncssh)
│ ├── paloalto_c.py # Palo Alto SSH PTY connector (asyncssh)
│ ├── panorama_c.py # Palo Alto Panorama REST API connector (httpx + XML→JSON)
│ ├── aruba_c.py # Aruba WiFi REST API connector (httpx)
│ ├── graylog_c.py # Graylog REST API connector (httpx)
│ ├── librenms_c.py # LibreNMS REST API connector (httpx)
│ ├── apic_c.py # Cisco APIC REST API connector (httpx + JWT cache)
│ └── ndfc_c.py # Cisco NDFC REST API connector (httpx + JWT cache)
├── skills/ # Diagnostic skills (Markdown procedures with YAML frontmatter)
│ ├── TEMPLATE.md # Template and frontmatter reference for new skills
│ ├── bgp-diagnostic-mikrotik.md # BGP session diagnostic on MikroTik
│ ├── connectivity-check.md # End-to-end connectivity check
│ ├── multicast-diagnostic-aci.md # ACI multicast diagnostic
│ ├── infrastructure-health-check.md # Multi-platform health overview (NOC/shift handover)
│ ├── wifi-health-monitoring.md # Aruba WiFi fleet health and RF audit
│ ├── device-deep-dive.md # Deep investigation of a single device (LibreNMS)
│ ├── aci-endpoint-tracking.md # Locate and diagnose an endpoint in ACI
│ ├── aci-fabric-health-diagnostic.md # ACI fabric degradation investigation
│ ├── aci-configuration-audit.md # ACI logical config consistency audit
│ ├── aci-traffic-analysis.md # ACI top talkers and interface utilization
│ ├── panorama-security-audit.md # Firewall security rules quality audit
│ ├── compliance-versions-certificates.md # Software versions and certificate expiry check
│ ├── change-pre-check.md # Baseline capture before a planned change
│ ├── change-post-check.md # Regression validation after a change
│ ├── configuration-drift-detection.md # Unauthorized change detection (multi-source)
│ ├── multi-vendor-inventory.md # Consolidated inventory across all platforms
│ ├── network-topology-mapping.md # LLDP-based physical topology discovery
│ ├── ndfc-deployment-validation.md # NDFC network/VRF deployment validation
│ ├── incident-root-cause-correlation.md # Multi-source incident correlation and timeline
│ └── capacity-planning-report.md # Infrastructure capacity assessment
├── pyproject.toml # UV project configuration and dependencies
├── uv.lock # UV dependency lockfile
├── .env # Environment variables (not version controlled)
├── .gitignore # Git ignore rules
└── README.md # Project documentation


### 技能体系

技能是存储为Markdown文件的逐步诊断和操作程序 `skills/*.md`每个文件都携带一个YAML frontmatter头(标题、平台、标签、所需工具),在服务器启动时解析为内存索引。两个专用的MCP工具暴露了系统。

**它是如何工作的:**

1. LLM电话 `skills_list()` 发现可用技能——只返回元数据(名称、标题、平台、标签、描述、所需工具),从不返回内容
1. 可选过滤器: `skills_list(platform="mikrotik")` 或 `skills_list(tag="bgp")`
1. LLM电话 `skills_load("bgp-diagnostic-mikrotik")` 检索完整过程——支持部分和不区分大小写的名称匹配;两者 `skill_name` 和 `name` 参数已被接受
1. Markdown内容描述了每个步骤:调用哪个MCP工具、预期结果和决策逻辑
1. LLM自主地遵循程序,按顺序调用引用的工具
1. 每一项技能都强制执行 **输出标准**:结构化的部分、专业的语气、适用于事故单、审计文件或管理简报的企业级报告

**创造新技能:**

1. 复制 `skills/TEMPLATE.md` 到 `skills/{subject}-{platform}.md`
1. 填写YAML frontmatter(标题、平台、标签、工具、描述)
1. 参考现有MCP工具编写程序步骤
1. 呼叫 `skills_list(reload=True)` 刷新索引--无需重新启动服务器

**Frontmatter模式** (每个技能档案中都需要):```yaml
---
title: BGP Diagnostic on MikroTik
platform: mikrotik  # mikrotik | aruba | aci | graylog | librenms | paloalto | panorama | generic
tags: [bgp, routing, peering, sessions]
tools: [get_mikrotik_bgp_sessions, get_mikrotik_bgp_connections]
description: One-sentence description of what this skill diagnoses.
---

可用技能(20):

技能 平台 类别 描述
bgp-diagnostic-mikrotik mikrotik 故障排除 BGP会话诊断(会话、配置、路由、日志)
connectivity-check 通用 故障排除 跨设备的端到端连接验证
multicast-diagnostic-aci aci 故障排除 aci结构多播诊断(GIPo、网桥域、IGMP)
infrastructure-health-check 通用 监控 国家奥委会/轮班交接的多平台健康状况概述
wifi-health-monitoring aruba 监控 WiFi车队健康状况:AP、客户端、RF信道、流氓AP
device-deep-dive librenms 监控 对单个设备(传感器、接口、日志)进行全面调查
aci-endpoint-tracking aci 故障排除 在aci结构中定位端点并诊断连接
aci-fabric-health-diagnostic aci 故障排除 aci结构退化:故障、节点、拓扑、资源
panorama-security-audit 全景 合规性 防火墙安全规则质量:配置文件、未使用的规则、覆盖
compliance-versions-certificates 全景 合规性 整个车队的软件版本矩阵和证书到期
aci-configuration-audit aci 合规性 aci逻辑配置一致性:租户、VRF、EPG、合同
change-pre-check 通用 变更管理 计划维护变更前的基线捕获
change-post-check 通用 变更管理 通过与预检查基线进行比较进行回归验证
configuration-drift-detection 通用 变更管理 Panorama、ACI和日志中未经授权的变更检测
multi-vendor-inventory 通用 库存 跨所有平台的合并库存(CMDB就绪)
network-topology-mapping 通用 库存 基于LLDP的物理拓扑发现和文档
aci-traffic-analysis aci 容量 aci顶级讲话者、接口利用率和TCAM容量
ndfc-deployment-validation 通用 自动化 NDFC网络/VRF部署状态和配置预览
incident-root-cause-correlation 通用 事件响应 多源时间线相关性,以确定根本原因
capacity-planning-report 通用 容量 跨所有域的基础设施容量评估

异步设计模式

1.持久HTTP会话

REST API连接器(Aruba、Graylog、LibreNMS)使用持久HTTP连接来最大限度地减少连接开销:```python
async with httpx.AsyncClient(timeout=30) as client:
response = await client.get(url, headers=headers)

HTTP session is automatically reused for subsequent requests


#### 2.线程安全JWT令牌缓存

APIC和NDFC连接器实现了具有自动续订功能的线程安全JWT令牌缓存:```python
_token_cache = {"token": None, "expires_at": 0, "lock": asyncio.Lock()}

async def _get_token():
async with _token_cache["lock"]:
if time.time() < _token_cache["expires_at"]:
return _token_cache["token"]
# Automatic token renewal when expired
return await _authenticate()

主要特点:

  • 异步锁阻止并发身份验证请求
  • 具有安全裕度的可配置令牌到期
  • 401响应自动续订
  • 零停机令牌刷新

3.具有超时保护的并行执行

SSH连接器支持跨多个设备并行执行命令:```python
async def send_custom_command_parallel(targets: List[Dict], timeout: int = 120):
tasks = [execute_single(target) for target in targets]
results = await asyncio.wait_for(
asyncio.gather(*tasks, return_exceptions=True),
timeout=timeout
)
return results


**优点:**

- 跨多个设备并发执行
- 全局超时防止无限期挂起
- 每个设备的异常处理
- 结果汇总在单个响应中

#### 4.PTY互动会议

由于非标准SSH实现,Palo Alto PAN-OS需要PTY(伪终端)交互会话:```python
async with asyncssh.connect(ip, ...) as conn:
async with conn.create_process(term_type='vt100') as process:
await process.stdin.write(command + '\n')
output = await process.stdout.read()

为什么需要PTY:

  • PAN-OS CLI需要交互式终端
  • 标准SSH执行通道被拒绝
  • 正确输出格式所需的终端仿真(vt100)

5.加密凭证注入(dotenvx)

凭据从不以纯文本形式存储。dotenvx拦截进程启动,解密 .env 文件(AES-256-GCM),并在Python启动之前将变量注入到进程环境中。应用程序代码为 os.getenv() 与往常一样,连接器无需更改。```
dotenvx run -- uv run python server.py
│
├─ reads .env (AES-256-GCM ciphertext)
├─ reads DOTENV_PRIVATE_KEY (from .env.keys or env field in MCP config)
├─ decrypts → injects into os.environ
└─ spawns Python process
└─ connectors read os.getenv("APIC_PASSWORD") → plaintext value


**关键属性:**

- 加密的 `.env` 可以提交到版本控制--仅限于密文
- 私钥(`.env.keys`)是唯一需要保护和分发的秘密
- dotenvx位于UV外部——通过Homebrew或安装脚本在每台机器上安装一次
- 如果 `DOTENV_PRIVATE_KEY` 缺失或无效,dotenvx会记录警告,但不会阻止启动——连接器将在第一次网络调用时失败 `None` 凭证错误

### 关键依赖关系

|库|版本|目的|
|---------|---------|---------|
| **fastmcp** |2.13+|带stdio传输的MCP服务器框架|
| **异步ssh** |2.21+|异步SSH客户端(RFC兼容+PTY支持)|
| **httpx** |0.28+|带连接池的异步HTTP客户端|
| **mcp\[cli\]** |1.23+|MCP协议实现和CLI工具|
| **Dotenx** *(外部)* |1.54+|加密 `.env` 管理——通过Homebrew安装,而不是UV|

______________________________________________________________________

## 测试

### 快速验证```bash
# Verify MCP server loads correctly (with encrypted .env)
dotenvx run -- uv run python -c "from server import mcp; print(f'{mcp.name} operational')"

# Test SSH connector
uv run python -c "
import asyncio
from connectors.ssh_c import send_custom_command
result = asyncio.run(send_custom_command('192.168.1.1', 'show version'))
print(result)
"

# Test REST API connector (LibreNMS)
uv run python -c "
import asyncio
from connectors.librenms_c import list_devices
result = asyncio.run(list_devices())
print(result)
"

响应格式

所有连接器函数都返回一个标准化的字典结构:```python
{
"success": bool, # True if operation completed successfully
"output": dict|str|list, # Response data (structure varies by connector)
"error": str # Error message if success is False
}


**成功响应示例:**```python
{
"success": True,
"output": {"hostname": "router-01", "version": "7.14.1"},
"error": None
}

错误响应示例:```python
{
"success": False,
"output": None,
"error": "Connection timeout after 30 seconds"
}


______________________________________________________________________

## 安全考虑

### 开发vs生产

|方面|开发环境|生产环境|
|--------|------------------------|------------------------|
| **凭证** |本地 `.env` file |机密管理器(HashiCorp Vault、AWS机密管理器、1Password CLI)|
| **SSL验证** | `VERIFY_SSL=false` (具有自签名证书的实验室设备)| `VERIFY_SSL=true` 具有有效的证书链|
| **SSH已知主机** |残疾人(`known_hosts=None`)用于快速原型制作|严格验证并维护 `known_hosts` 文件|
| **帐户权限** |完全访问的管理员帐户|具有最低所需权限的服务帐户(最小权限原则)|
| **日志记录** |启用调试日志以进行故障排除|禁用会话日志以防止凭据暴露|
| **网络接入** |直接设备访问|使用防火墙规则通过堡垒主机/跳转服务器限制访问|

### 生产凭证管理

使用1Password CLI进行安全凭据注入的示例:```bash
# Launch server — dotenvx decrypts .env at startup using the private key
dotenvx run -- uv run python server.py

# Alternative: inject private key from a secrets manager (1Password, Vault, etc.)
export DOTENV_PRIVATE_KEY=$(op read "op://Production/netai/dotenv-private-key")
dotenvx run -- uv run python server.py

审计与合规

对于生产部署:

  • 为所有MCP工具调用启用审核日志记录
  • 在MCP客户端级别实现基于角色的访问控制(RBAC)
  • 定期轮换服务帐户凭据(最多90天)
  • 监控可疑的命令模式或未经授权的访问尝试
  • 维护所有配置更改的审计跟踪

故障排除

常见问题及解决方法

问题 诊断 解决方案
SSH身份验证失败 凭据不正确或帐户已锁定 验证 SSH_USERNAME 和 SSH_PASSWORD 在 .env.手动测试: ssh user@host。检查目标设备上的帐户状态。
连接超时 网络无法访问或防火墙阻止 验证连接: ping, telnet.检查防火墙规则和路由。增加超时值 .env.
SSL/TLS证书错误 自签名证书或不受信任的CA 开发:设置 VERIFY_SSL=false生产:安装正确的CA证书或使用 certifi 捆绑。
JWT令牌已过期(APIC/NDFC) 超过令牌寿命 令牌续订是自动的。如果持续存在,请验证凭据并检查APIC/NFC身份验证日志。
MCP服务器无法启动 缺少依赖项或Python版本不匹配 检查 uv --version 和 python --version (必须为3.12+)。重新运行 uv sync 重新安装依赖关系。
Palo Alto会话超时 PAN-OS攻击性会话超时 增加 timeout 工具调用中的参数。考虑实现保活数据包。
Librenms API 401错误 API令牌无效或过期 根据用户设置在LibreNMS web界面中重新生成API令牌。更新 LIBRENMS_API_TOKEN 在 .env.
禁止使用APIC/NDFC 403 帐户权限不足 验证帐户是否具有所需的角色分配(管理员或结构管理员可获得完全访问权限)。

启用调试日志记录

添加以下内容 server.py 有关详细的日志输出:```python
import logging
logging.basicConfig(
level=logging.DEBUG,
format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
)


对于生产环境,将日志记录配置为外部syslog或SIEM:```python
import logging
from logging.handlers import SysLogHandler

handler = SysLogHandler(address=('syslog.example.com', 514))
logging.basicConfig(handlers=[handler], level=logging.INFO)

路线图

当前实现

  • [x] 100%异步架构(asyncio/asyncssh/httpx)
  • [x] 10个连接器(SSH、MikroTik REST+SSH、Aruba、Palo Alto SSH、Panorama、Graylog、LibreNMS、APIC、NDFC)
  • [x] 97个暴露的MCP工具(95个连接器+2个技能工具)
  • [x] 智能JWT缓存,可自动续订
  • [x] 带有keepalive的持久HTTP会话
  • [x] 具有超时保护的并行执行
  • [x] 对Palo Alto PAN-OS的PTY支持
  • [x] 现代紫外线管理(pyproject.toml+UV.lock)
  • [x] 使用dotenvx(AES-256-GCM)进行加密凭据管理
  • [x] Panorama API与XML的集成→JSON转换
  • [x] 具有内存索引、YAML frontmatter、平台/标签过滤和模糊名称匹配的技能系统
  • [x] 7个运营类别(监控、故障排除、合规性、变更管理、库存、容量、事件响应)的20项专业技能
  • [x] 企业产出标准在每项技能中都得到了执行(结构化报告、专业语气、企业就绪)

计划中的增强功能

附加平台支持和更多端点:

  • []添加更多LibreNMS端点(警报、设备组、库存)
  • []添加更多APIC端点(故障排除、变更管理)
  • []扩展Aruba功能(射频分析、热图)
  • []扩展全景功能(策略推送、提交操作)

技能:

  • []OSPF诊断技能(MikroTik/通用)
  • []VPN隧道诊断技能(Palo Alto)
  • []WiFi客户端故障排除技能(阿鲁巴)
  • []事故后验尸报告技能

许可证

该项目根据MIT许可证获得许可。请参阅 许可证 提交完整的条款和条件。


致谢

  • FastMCP -高性能MCP服务器框架
  • 异步ssh -生产级异步SSH实现
  • httpx -支持HTTP/2的现代异步HTTP客户端
  • 紫外线 -Rust内置的下一代Python包管理器
  • Anthropic -模型上下文协议规范和参考实现

支持

对于问题、疑问或贡献:

  • 问题追踪: GitHub问题
  • 讨论: GitHub讨论

面向企业环境的专业网络自动化

常见问题

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

在客户端按下面的安装命令接入:uv run python -c "from server import mcp; print(f'{mcp.name} operational')"。装完在客户端配置里引用同一个包或端点。

Git Netai 怎么在 Claude Desktop、Claude 里配置?

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

Git Netai 收费吗?

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

Git Netai 需要 API Key 吗?

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

Git Netai 支持哪些客户端?

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

Git Netai 能提供哪些能力?

资料显示约 10 个工具;能力标签包括 网络管理、多平台支持、Python、Claude。具体工具清单以官方文档为准。

Git Netai 需要什么运行环境?

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

Git Netai 是本地还是远程?

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

热门专题

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

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