Skip to content

Releases: netboxlabs/netbox-mcp-server

v1.2.1

Choose a tag to compare

@github-actions github-actions released this 17 Jun 20:10
8d02e9a

Bug Fixes

  • deps: Bump cryptography, pyjwt, python-multipart for security advisories
    (#161,
    238f423)

  • deps: Update non-major python dependencies
    (#150,
    8b5fd4b)

  • deps: Update non-major python dependencies
    (#135,
    6d4c13b)

  • transport: Add optional bearer token authentication for HTTP transport
    (#162,
    17df465)

Chores

  • deps: Bump gitpython to 3.1.50 and pygments to 2.20.0
    (3d08421)

  • deps: Update non-major docker dependencies
    (#160,
    9a0316f)

  • deps: Update non-major github actions
    (#158,
    6658b92)

  • deps: Update sigstore/cosign-installer action to v4
    (#141,
    1a6bfd6)

  • renovate: Add top-level minimumReleaseAge for full coverage
    (#156,
    a06a2e4)

  • renovate: Extend the central org preset
    (#157,
    9638a48)

  • renovate: Raise stability window to 7-day org standard
    (#154,
    3adb98c)

Documentation

  • Add Community section and remove em dashes
    (#149,
    6c97e7e)

Reported by @fortress07. Thanks for the responsible disclosure.

v1.2.0

Choose a tag to compare

@github-actions github-actions released this 26 May 18:30
716da61

Bug Fixes

  • Reject __in lookups, suggest list-as-value form
    (#144,
    7900563)

  • ci: Extract full release notes from CHANGELOG
    (#118,
    d5b3657)

  • ci: Regenerate uv.lock in release PR workflow
    (#118,
    d5b3657)

  • deps: Update non-major python dependencies
    (2bd86b2)

  • filters: Reject relationship id list lookups
    (#144,
    7900563)

Chores

  • Regenerate uv.lock for v1.1.0 version bump
    (#118,
    d5b3657)

  • ci: Sign and attest published images, pin base by digest
    (#134,
    17f4866)

  • deps: Bump the uv group across 1 directory with 2 updates
    (#146,
    c7838cc)

  • deps: Bump the uv group across 1 directory with 5 updates
    (#133,
    613395c)

  • deps: Bump urllib3 in the uv group across 1 directory
    (#140,
    c1912eb)

  • deps: Update actions/attest-build-provenance action to v4
    (#139,
    335cad8)

  • deps: Update actions/github-script action to v9
    (#111,
    a65bbca)

  • deps: Update dependency pytest to v9.0.3 [security]
    (efb955d)

  • deps: Update github/codeql-action action to v4.35.3
    (5d728c6)

  • deps: Update non-major github actions
    (#138,
    8f80b9d)

  • deps: Update python:3.14-alpine3.23 docker digest to 5a824eb
    (#142,
    8f8c25c)

Continuous Integration

  • Publish images to Docker Hub instead of GHCR
    (ea7b264)

  • Skip floating tags for pre-release versions
    (6a86784)

Documentation

  • Add CONTRIBUTING.md and clarify project scope
    (#128,
    d22280b)

  • Clarify NetBox lookup filter support
    (#144,
    7900563)

Features

v1.1.0

Choose a tag to compare

@github-actions github-actions released this 20 Apr 20:12
2a78ff7

Bug Fixes

  • Exclude requires-python from Renovate bumps
    (e7c7c44)

  • Gracefully handle fork PR comment permissions
    (1c38983)

  • Handle bearer authentication for v2 tokens
    (4a80e22)

  • Handle edge cases in filter parsing for n8n compatibility
    (#61,
    d6f4c12)

  • Improve n8n MCP (#61,
    d6f4c12)

  • Improve n8n MCP client compatibility with JSON Schema types
    (#61,
    d6f4c12)

  • Lower minimum supported Python version to 3.11
    (#66,
    9120b22)

  • Restore Dockerfile and lockfile from main
    (#61,
    d6f4c12)

  • Scope requires-python exclusion to pep621 manager only
    (e1f0ff5)

  • Upgrade vulnerable dependencies and Alpine packages
    (9d908b0)

  • Use string types for n8n MCP client compatibility
    (#61,
    d6f4c12)

  • ci: Add CHANGELOG insertion flag for python-semantic-release v10
    (#116,
    6543edf)

  • ci: Pin GitHub Actions to commit SHAs for security
    (#67,
    8ce4429)

  • deps: Update dependency fastmcp to >=3.2.0,<4
    (3178086)

  • deps: Update non-major python dependencies
    (aba4862)

  • docker: Use Python 3.13 for pre-built wheel availability
    (#61,
    d6f4c12)

  • tests: Update for FastMCP 3.x API (remove .fn from tool calls)
    (9331910)

Chores

  • Add ruff as linter (#65,
    56ff780)

  • Add ruff as linter (#62,
    b1d1fe1)

  • Added in full set of linting and applied lints
    (#65,
    56ff780)

  • Moved ruff to dev and added pre-commit hook
    (#65,
    56ff780)

  • Run ruff on repo (#65,
    56ff780)

  • Set rangeStrategy to bump in Renovate config
    (7ab23dd)

  • ci: Add Ruff and Python matrix in workflow
    (#66,
    9120b22)

  • deps: Bump cryptography in the uv group across 1 directory
    (#110,
    a740f5a)

  • deps: Bump fastmcp to 2.14.x to address security concerns
    (#60,
    bb32fe3)

  • deps: Bump filelock in the uv group across 1 directory
    (#71,
    14ec2fe)

  • deps: Bump python-multipart in the uv group across 1 directory
    (#70,
    9137450)

  • deps: Bump virtualenv in the uv group across 1 directory
    (#68,
    9df2ced)

  • deps: Pin GitHub Actions digests in Renovate config
    (7920fe7)

  • deps: Remove ruff dependency from main project deps and lock files
    (a128ddd)

  • deps: Update actions/checkout action to v6
    (8e1088a)

  • deps: Update actions/setup-python action to v6
    (0bc4c1a)

  • deps: Update astral-sh/setup-uv action to v8
    (965ab93)

  • deps: Update dependencies and Python support
    (#63,
    92a923a)

  • deps: Update dependency fastmcp to v3.2.0 [security]
    (f165558)

  • deps: Update dependency pytest to v9.0.3 [security]
    (#113,
    48bb7a6)

  • deps: Update docker/build-push-action action to v7
    (c4cd483)

  • deps: Update docker/login-action action to v4
    (c975c32)

  • deps: Update docker/metadata-action action to v6
    (f2208db)

  • deps: Update docker/setup-buildx-action action to v4
    (be31cc8)

  • deps: Update docker/setup-qemu-action action to v4
    (628dd4a)

  • deps: Update multiple Python dependencies
    (1c20ac6)

  • deps: Update non-major github actions
    (#109,
    480795f)

  • deps: Update non-major github actions
    (d40d861)

  • deps: Update ruff-pre-commit to v0.15.2
    (308f9a0)

  • deps: Upgrade FastMCP 3
    (ece2bef)

  • docker: Update Python base image and enhance metadata
    (#64,
    a29f43b)

Continuous Integration

Read more

v1.0.0

Choose a tag to compare

@abubnalitic-nbl abubnalitic-nbl released this 31 Oct 20:22

v1.0.0 (2025-10-31)

🚨 BREAKING CHANGES

Simpler installation and execution. The server now uses a standard Python package layout with a dedicated command. You'll need to update your configuration:

  • Command change: uv run server.pyuv run netbox-mcp-server
  • Claude Desktop/Code: Update args to use netbox-mcp-server instead of server.py
  • Docker: Rebuild images (CMD updated to use new entry point)

See README.md for updated configuration examples.

What's New

Enhanced Search & Querying

  • Global search across object types: New netbox_search_objects tool lets you search for devices, sites, IP addresses, and more in a single query
  • Selective field filtering: Reduce token usage by requesting only the fields you need (e.g., just name and status instead of complete objects)
  • Smarter pagination: Control result set sizes with limit and offset parameters, plus automatic count, next, and previous metadata for navigating large datasets
  • Custom result ordering: Sort results by any field with the ordering parameter (e.g., -name for reverse alphabetical, or ['site', '-id'] for multi-field sorting)
  • Better error messages: Input validation now catches unsupported filter patterns before they reach the NetBox API

Easier Deployment & Configuration

  • Simple command: Run with netbox-mcp-server instead of python server.py
  • Docker support: Official Dockerfile for containerized deployments
  • Flexible configuration: Pass settings via environment variables or command-line arguments
  • Configurable logging: Set LOG_LEVEL environment variable to control verbosity (default: INFO)

Security & Reliability

  • Security update: Upgraded to FastMCP 2.13 to address security vulnerability
  • Production-ready: Comprehensive CI/CD pipeline with automated testing against live NetBox instances