Skip to content

Add OCI IoT gateway-aware MCP support#348

Closed
wsanders00 wants to merge 1 commit into
oracle:mainfrom
wsanders00:pr/oci-iot-mcp-gateway-awareness
Closed

Add OCI IoT gateway-aware MCP support#348
wsanders00 wants to merge 1 commit into
oracle:mainfrom
wsanders00:pr/oci-iot-mcp-gateway-awareness

Conversation

@wsanders00

@wsanders00 wsanders00 commented Jun 23, 2026

Copy link
Copy Markdown
Member

Description

Adds gateway-aware OCI IoT MCP support for src/oci-iot-mcp-server.

Fixes #347

This change:

  • Preserves and accepts gateway-aware digital twin instance fields, including connectivity_type and gateways.
  • Adds agent-friendly topology and readiness helpers for gateway-aware twin workflows.
  • Adds relationship pagination helpers plus SDK-parity filters/pagination arguments for IoT list tools.
  • Preserves more SDK fields in digital twin model and relationship mapped outputs.
  • Updates the OCI IoT MCP README and tests for the expanded tool surface.
  • Refreshes the OCI IoT MCP dependency lockfile, including oci==2.180.0.

No new OCI IoT SDK service surface was found in oci==2.180.0; the SDK bump is dependency hygiene for this PR.

Type of change

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • This change requires a documentation update

How Has This Been Tested?

  • uv run pytest oracle/oci_iot_mcp_server/tests
  • PATH=.venv/bin:$PATH make test project=oci-iot-mcp-server
  • make lint
  • make lock-check project=oci-iot-mcp-server
  • git diff --check
  • uv lock --upgrade --dry-run
  • uv tree --outdated --depth 1
  • uv tool run pip-audit --path .venv/lib/python3.13/site-packages --progress-spinner off

Test result summary:

  • uv run pytest oracle/oci_iot_mcp_server/tests: 275 passed
  • make test project=oci-iot-mcp-server: 275 passed, package coverage 91.44%, combined coverage 91%
  • make lint: passed
  • make lock-check project=oci-iot-mcp-server: passed
  • git diff --check: passed
  • uv lock --upgrade --dry-run: no lockfile changes
  • uv tree --outdated --depth 1: direct dependencies current
  • pip-audit: reports only cryptography 46.0.7 / GHSA-537c-gmf6-5ccf, fixed in 48.0.1; current OCI SDK metadata constrains cryptography<47.0.0

Sergio tested and approved the gateway-aware MCP behavior on 2026-06-19. Since that approval, the current PR tip differs from the approved feature commit only in src/oci-iot-mcp-server/uv.lock dependency refreshes plus branch packaging.

Test Configuration:

  • Firmware version: N/A
  • Hardware: N/A
  • Toolchain: Python 3.13.9, uv, pytest 9.1.1
  • SDK: OCI Python SDK 2.180.0

Checklist:

  • My code follows the style guidelines of this project
  • I have performed a self-review of my own code
  • I have commented my code, particularly in hard-to-understand areas
  • I have made corresponding changes to the documentation
  • My changes generate no new warnings
  • I have added tests that prove my fix is effective or that my feature works
  • New and existing unit tests pass locally with my changes
  • Any dependent changes have been merged and published in downstream modules

@oracle-contributor-agreement oracle-contributor-agreement Bot added the OCA Verified All contributors have signed the Oracle Contributor Agreement. label Jun 23, 2026
@wsanders00 wsanders00 force-pushed the pr/oci-iot-mcp-gateway-awareness branch from a61185e to 49aea78 Compare June 23, 2026 22:05
Add gateway-aware digital twin fields, topology/readiness helpers, relationship pagination, SDK-parity list filters, mapper fidelity improvements, and refreshed OCI IoT MCP dependencies.

Signed-off-by: Rayne Sanders <[email protected]>
@wsanders00 wsanders00 force-pushed the pr/oci-iot-mcp-gateway-awareness branch from 49aea78 to 7d580ac Compare June 27, 2026 13:16
@wsanders00 wsanders00 closed this Jun 28, 2026
@wsanders00 wsanders00 deleted the pr/oci-iot-mcp-gateway-awareness branch June 29, 2026 17:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

OCA Verified All contributors have signed the Oracle Contributor Agreement.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add gateway-aware OCI IoT MCP support

1 participant