Snmp Sse Mcp Server
About
Model Context Protocol (MCP) servers and clients
Details
- Author
- aimiox
- Downloads
- 249
- Categories
- Other, Infrastructure, Media
Jump to
- Automatically discover SNMP-enabled devices on the network
- Register, update, and remove SNMP devices
- Perform SNMP get and walk operations with OID validation
- Map OIDs to human-readable MIB names and descriptions
- Flexible device lookup by ID, IP address, or system name
- Compatible with OpenAI Agent SDK’s MCPServerSse
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Snmp Sse Mcp ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Run the server in a Docker container with a config.yaml file and a data directory. Optionally set the AMX_SNMP_PORT environment variable (default 8001). For testing, use the provided snmp_mcp_cli.py client with the OpenAI Agents SDK, after setting your OpenAI API key and MCP endpoint URL.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"snmp sse mcp server": {
"amx-snmp": {
"command": "docker",
"args": [
"run",
"-it",
"-p 8001:8001",
"-v $(pwd)/config.yaml:/app/config.yaml",
"-v $(pwd)/data:/app/data",
"amx-snmp-mcp:latest"
]
}
}
}
}McpServers
{
"amx-snmp": {
"command": "docker",
"args": [
"run",
"-it",
"-p 8001:8001",
"-v $(pwd)/config.yaml:/app/config.yaml",
"-v $(pwd)/data:/app/data",
"amx-snmp-mcp:latest"
]
}
}🖥️ SNMP MCP SSE Server
The aimiox SNMP MCP SSE Server integrates easily with the OpenAI Agents SDK or any SSE compatible MCP client, providing a seamless interface for SNMP device and MIBs interaction and monitoring.
✨ Features
✅ Device Discovery: Automatically discover SNMP-enabled devices on the network
📡 Device Management: Register, update, and remove SNMP devices
🔍 SNMP Operations: Perform SNMP get and walk operations with OID validation
📊 MIB Support: Map OIDs to human-readable MIB names and descriptions
🔄 Flexible Device Lookup: Identify devices by ID, IP address, or system name
🌐 OID Validation: Prevents walking top-level MIBs to avoid excessive data retrieval
🤖 Compatible with OpenAI Agent SDK's MCPServerSse: Easy integration with AI agents
🚀 Quick Start
Running the Server
Create a directory for config.yaml and data, e.g amx-snmp. Edit config.yaml and add your devices. Create "data" directory for the database.
In the same directory, you can run the server in a docker container with:
$ sudo docker run -it \
-p 8001:8001 \
-v $(pwd)/config.yaml:/app/config.yaml \
-v $(pwd)/data:/app/data \
aimiox/amx-snmp-mcp:latest
⚙️ Configuration
| Env Variable | Default | Description |
|------------------------|-------------|-----------------------------------|
| AMX_SNMP_PORT | 8001 | Port to listen on |
💎 Premium Features
The free version supports 2 devices.
The paid version adds support for:
- 100+ devices
- OID data history
🛠️ For paid access or custom integration, email us
🧪 Test with CLI Client
To test the SNMP MCP server using the OpenAI Agents SDK, use the included cli.py.
1. Set Your API Key
Create a .env file in the project root and add:
OPENAI_API_KEY=your-openai-key-here
2. Set the MCP Endpoint
Edit the following line insnmp_mcp_cli.py:
MCP_SNMP_URL = "http://<mcp_ip_address>:<mcp_port>/sse"
3. Run the Client
pip install openai-agents
python3 snmp_mcp_cli.py
4. Interact with the Agent
The client will connect to the SSE server and allow you to chat with SNMP MCP.
🤖 Example Response (via GPT-4.1-mini)
User Prompt:
> 💻 You: How can you help me with SNMP devices?
AI Response:
> 🤖 Assistant:
> I can help you with SNMP devices in several ways, including:
> 1. Retrieving information from SNMP-enabled devices, such as system details, interface statistics, CPU and memory usage, disk I/O, and more.
> 2. Performing SNMP walk operations to browse whole OID subtrees or get specific OID values.
> 3. Listing all SNMP devices that you have configured.
> 4. Providing details about available MIB modules and specific objects within those MIBs.
> 5. Fetching historical SNMP data if it's available for monitoring trends over time.
> You can ask me to query specific data points or perform walks on your SNMP devices and I will retrieve the relevant information for you. How would you like to start?
📞 Support
For questions, issues, or contributions, open an issue on github.com/aimiox/mcp, or email us
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
