Snmp Sse Mcp Server

🖥️ SNMP MCP SSE 服务

aimiox SNMP MCP SSE 服务可轻松集成 OpenAI Agents SDK 或任何兼容 SSE 的 MCP 客户端，为 SNMP 设备和 MIB 的交互与监控提供无缝接口。

✨ 功能

✅ 设备发现：自动发现网络中启用了 SNMP 的设备

📡 设备管理：注册、更新和移除 SNMP 设备

🔍 SNMP 操作：执行 SNMP get 和 walk 操作，并验证 OID

📊 MIB 支持：将 OID 映射为易于理解的 MIB 名称和描述

🔄 灵活的设备查找：按 ID、IP 地址或系统名称识别设备

🌐 OID 验证：避免遍历顶层 MIB，以防检索过多数据

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

🚀 快速开始

运行服务

创建一个用于存放 config.yaml 和数据的目录，例如 amx-snmp。编辑 config.yaml 并添加设备。创建 "data" 目录用于存放数据库。

在同一目录中，可以通过 Docker 容器运行服务：

$ sudo docker run -it \
  -p 8001:8001 \
  -v $(pwd)/config.yaml:/app/config.yaml \
  -v $(pwd)/data:/app/data \
  aimiox/amx-snmp-mcp:latest

⚙️ 配置

环境变量	默认值	描述
AMX_SNMP_PORT	8001	监听端口

💎 高级功能

免费版本支持 2 台设备。

付费版本还支持：

• 100+ 台设备
• OID 数据历史记录

🛠️ 如需付费访问或定制集成，请发送邮件联系我们

🧪 使用 CLI 客户端测试

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

1. 设置 API 密钥

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

OPENAI_API_KEY=your-openai-key-here

2. 设置 MCP 端点

编辑 snmp_mcp_cli.py 中的以下行：

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

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

3. 运行客户端

pip install openai-agents
python3 snmp_mcp_cli.py

4. 与 Agent 交互

客户端将连接到 SSE 服务，让你能够与 SNMP MCP 对话。

🤖 响应示例（通过 GPT-4.1-mini）

用户提示词：

💻 你：你能如何帮助我处理 SNMP 设备？

AI 响应：

🤖 助手： 我可以通过多种方式帮助你处理 SNMP 设备，包括：

1. 从启用了 SNMP 的设备检索信息，例如系统详情、接口统计数据、CPU 和内存使用情况、磁盘 I/O 等。
2. 执行 SNMP walk 操作以浏览整个 OID 子树，或获取特定 OID 值。
3. 列出你已配置的所有 SNMP 设备。
4. 提供可用 MIB 模块及其中特定对象的详情。
5. 如果有历史 SNMP 数据，可获取这些数据以监控随时间变化的趋势。

你可以让我查询特定数据点，或对 SNMP 设备执行 walk 操作，我会为你检索相关信息。你想从哪里开始？

📞 支持

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