mcp-infoblox

A Model Context Protocol (MCP) server for Infoblox NIOS, providing AI assistants with full access to DNS, DHCP, and IPAM management through the Infoblox WAPI REST API.

Features

35 tools across five categories:

DNS Record Management

Network & IPAM

DHCP

DNS Zones

Grid & Infrastructure

Installation

git clone git@github.com:fredriksknese/mcp-infoblox.git
cd mcp-infoblox
npm install
npm run build

Configuration

The server is configured via environment variables:

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "infoblox": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-infoblox/dist/index.js"],
      "env": {
        "INFOBLOX_HOST": "your-infoblox-server.example.com",
        "INFOBLOX_USERNAME": "admin",
        "INFOBLOX_PASSWORD": "your-password"
      }
    }
  }
}

Usage with Claude Code

Add to your Claude Code MCP settings:

claude mcp add infoblox -- node /absolute/path/to/mcp-infoblox/dist/index.js

Set the required environment variables before running, or configure them in your MCP settings.

Example Prompts

Once connected, you can ask your AI assistant things like:

• "Show me all A records in the example.com zone"
• "Create a host record for server01.example.com with the next available IP in 10.0.1.0/24"
• "What DHCP leases are active on the 192.168.1.0/24 network?"
• "Find all DNS records pointing to 10.0.0.5"
• "Get the next 5 available IPs from the 10.10.0.0/16 network"
• "Create a CNAME alias web.example.com pointing to lb.example.com"
• "Show me network utilization for all 10.x networks"
• "Restart DNS services on the grid"

Development

npm run dev      # Run with tsx (auto-reloads)
npm run build    # Compile TypeScript to dist/
npm start        # Run compiled output

Architecture

src/
├── index.ts              # Entry point — creates MCP server + STDIO transport
├── infoblox-client.ts    # HTTP client wrapping Infoblox WAPI
└── tools/
    ├── dns.ts            # DNS record CRUD (12 tools)
    ├── network.ts        # Network/IPAM management (6 tools)
    ├── dhcp.ts           # DHCP management (6 tools)
    ├── zone.ts           # DNS zone management (3 tools)
    └── grid.ts           # Grid, search, views, extensible attrs (8 tools)

Requirements

• Node.js 18+
• Infoblox NIOS with WAPI enabled (tested with WAPI v2.12+)

License

MIT