Network Devices Mcp Sse Server

🖥️ AMXNet - 网络设备 MCP 服务

aimiox AMXNet 网络设备 MCP 服务支持通过 OpenAI Agents SDK 或任何兼容 SSE 的 MCP 客户端与网络设备无缝交互。它提供了强大的接口，用于管理、监控和控制服务器、路由器、交换机等已连接设备。

📋 目录

• 功能
• 架构
• 安装
  • Docker
  • 手动安装
• 配置
• 设备客户端
• 使用 CLI 测试
• 高级功能
• 使用示例
• 支持

✨ 功能

📡 设备管理：注册、监控和控制远程设备

🔍 文件操作：列出、读取、写入和搜索已连接设备上的文件

📊 系统监控：查看系统信息、进程和资源使用情况

🔄 命令执行：在远程设备上运行 Shell 命令（高级版本提供相应权限）

🌐 跨平台支持：支持 Linux、OpenWRT 和 OpenBSD* 设备

🔒 安全通信：通过 TLS 加密设备连接

🤖 兼容 OpenAI Agent SDK：轻松集成 AI Agent

🏗️ 架构

AMXNet 由两个主要组件组成：

1. AMXNet MCP 服务：处理以下组件间通信的中心服务：

   • 设备客户端（通过端口 8765 上的 WebSockets）
   • MCP 主机/AI Agent（通过端口 8002 上的 SSE）

2. AMXNet 设备客户端：运行于网络设备上的轻量级 C 客户端

   • 支持多种架构（x86_64、ARM、MIPS）
   • 无库依赖，具有出色的可移植性
   • 资源占用极少

🚀 安装

使用 Docker（推荐）

运行 AMXNet 最简单的方式是使用我们的 Docker 镜像：

# Pull the latest image
docker pull aimiox/amxnet-mcp:latest

# Run the server
sudo ./run_amxnet_mcp.sh

也可以使用 Docker 手动运行：

sudo docker run -d --rm \
  -p 8765:8765 \
  -p 8002:8002 \
  -e AMXNET_DEVICE_PORT=8765 \
  -e AMXNET_SSE_PORT=8002 \
  --name amxnet-mcp \
  aimiox/amxnet-mcp:latest

⚙️ 配置

AMXNet 可通过环境变量进行配置：

环境变量	默认值	描述
AMXNET_DEVICE_PORT	8765	设备使用的 WebSocket 端口
AMXNET_SSE_PORT	8002	MCP 主机/AI 使用的 SSE 端口

📱 设备客户端

AMXNet 设备客户端是一款轻量级应用，可在网络设备上运行并连接到 AMXNet MCP 服务。

支持的架构

我们为多种架构提供预构建的二进制文件：

• x86_64（64 位）：适用于标准 Linux 服务器和桌面设备
• ARM（32 位）：适用于 OpenWRT 路由器、Raspberry Pi 和其他 ARM 设备
• MIPS：适用于较旧的 OpenWRT 路由器和嵌入式设备

在设备上安装

1. 下载适用于设备架构的二进制文件
2. 将其设为可执行文件： chmod +x amxnet_device_client_<ARCH>
3. 使用服务地址运行： ./amxnet_device_client_<ARCH> --name <device_name> --server <server_ip> --port <server_port>

💎 高级功能

免费版本支持 2 台设备。付费版本增加以下支持：

• 100 台以上设备：连接和管理 100 台以上设备
• 命令执行：修改文件并在设备上执行命令
• 自定义集成：与现有系统集成
• 优先支持：直接联系我们的工程团队

🧪 使用 CLI 客户端测试

要使用 OpenAI Agents SDK 测试 SNMP MCP 服务，请使用随附的 cli.py。

1. 设置 API 密钥

在项目根目录中创建 .env 文件并添加：

OPENAI_API_KEY=your-openai-key-here

2. 设置 MCP 端点

编辑 amxnet_cli.py 中的以下行：

MCP_AMXNET_URL = "http://<mcp_ip_address>:<mcp_port>/sse"

将 <mcp_ip_address> 和 <mcp_port> 替换为实际的服务值。

3. 运行客户端

pip install openai-agents
python3 amxnet_cli.py

4. 与 Agent 交互

客户端将连接到 SSE 服务，并允许你与 AMXNet Network Devices MCP 聊天。

🤖 示例回复（通过 GPT-4.1-mini）

用户提示词：

💻 你：我可以如何使用你来管理我的网络设备？

AI 回复：

🤖 助手： 我可以协助你处理与网络设备相关的各种任务，例如：

1. 列出所有网络设备及其状态。
2. 获取特定设备的详细信息。
3. 查看设备的系统信息、负载和网络数据。
4. 列出设备上的文件并读取文件内容。
5. 搜索、复制、比较设备上的文件，并创建文件。
6. 监控设备上正在运行的进程。
7. 在设备上执行 shell 命令（如果你拥有必要的权限）。
8. 刷新设备列表，以获取最新状态。

告诉我你需要我为你的网络设备提供哪些具体帮助！

📞 支持

如有疑问、问题或贡献，请在 github.com/aimiox/mcp 上提交 issue，或发送邮件联系我们