Ryan Malloy
ca6956e826
Renames the package from `mcp-cucm-axl` to `mcaxl` to fit the
operator's mc<interface> naming convention (mcusb, mcaxl, …),
and scrubs Bingham-specific defaults so the package works for
anyone, anywhere.
Rename:
- pyproject.toml: name, scripts entry point, description
- src/mcp_cucm_axl/ → src/mcaxl/ (git mv preserves history)
- All Python imports updated via sed
- Cache directory: ~/.cache/mcp-cucm-axl/ → ~/.cache/mcaxl/
- Log prefix [mcp-cucm-axl] → [mcaxl]
- Package version lookup: importlib.metadata.version("mcaxl")
- .mcp.json command updated to invoke `mcaxl` script
- All 155 tests pass under the new name (verified)
Bingham-specific scrubs:
- docs_loader._DEFAULT_INDEX_DIR: hardcoded /home/rpm/bingham/...
path removed; defaults to None. Operators set CISCO_DOCS_INDEX_PATH
env var; without it, prompts gracefully degrade with a fallback
notice instructing the LLM to use the cisco-docs MCP search_docs
tool instead.
- prompts/_common.docs_or_empty_msg: removed the explicit
/home/rpm/bingham/... path from the fallback message text.
- server.py: removed dead-code copy of _docs_or_empty_msg() that
was leftover from before the prompts package extraction.
- README.md: completely rewritten as a public-facing readme. Lead
paragraph names CUCM as the target platform, install instructions
cover uvx / pip / Claude Code MCP add. Recommends cisco-cucm-mcp
as the operations counterpart.
PyPI metadata:
- Initial CalVer version: 2026.04.27
- License: MIT (LICENSE file added)
- Project URLs: Homepage / Source / Issues / Changelog all point
at git.supported.systems/mcp/mcaxl (newly-created Gitea repo
in the mcp/ org for PyPI releases)
- Classifiers: Beta / Telecommunications Industry / Topic:Telephony
- Keywords: mcp, cisco, cucm, axl, risport, voip, sip, audit
- sdist excludes: CLAUDE.md, .env*, axlsqltoolkit.zip, audits/,
tests/, pytest/ruff caches. Verified clean: wheel ships only the
mcaxl/ source tree + LICENSE + METADATA + entry_points.
CHANGELOG.md added with a 2026.04.27 initial-release entry,
documenting tool/prompt counts, structural read-only guarantees,
Hamilton review closure, live-cluster verification, and known
limitations.
Build verification:
- `uv build` produces clean wheel + sdist
- Wheel: 22 source files, 195KB total, no Bingham-specific files
- Sdist excludes verified: no CLAUDE.md, no axlsqltoolkit.zip
- Entry point: `mcaxl = mcaxl.server:main`
- Package installs as mcaxl==2026.4.27
68 lines
2.7 KiB
Markdown
68 lines
2.7 KiB
Markdown
# Changelog
|
|
|
|
This project uses [CalVer](https://calver.org/) — version numbers
|
|
encode the date the package was tested against the upstream Cisco APIs
|
|
and published. Format: `YYYY.MM.DD` with optional `.N` post-release
|
|
suffix for same-day fixes.
|
|
|
|
## 2026.04.27 — initial public release
|
|
|
|
First public release on PyPI as `mcaxl`. Renamed from the internal
|
|
working name `mcp-cucm-axl` to fit the operator's `mc<interface>`
|
|
naming convention.
|
|
|
|
### Tools (19 total)
|
|
|
|
**Foundational**: `axl_version`, `axl_sql`, `axl_list_tables`,
|
|
`axl_describe_table`, `cache_stats`, `cache_clear`, `health`.
|
|
|
|
**Route plan**: `route_partitions`, `route_calling_search_spaces`,
|
|
`route_patterns`, `route_inspect_pattern`, `route_lists_and_groups`,
|
|
`route_translation_chain`, `route_digit_discard_instructions`,
|
|
`route_device_pool_route_groups`, `route_devices_using_css`,
|
|
`route_filters`.
|
|
|
|
**Real-time registration (RisPort70)**: `device_registration_status`,
|
|
`device_registration_summary`.
|
|
|
|
### Prompts (10 total)
|
|
|
|
Schema-grounded conversation seeds: `route_plan_overview`,
|
|
`investigate_pattern`, `audit_routing`, `cucm_sql_help`,
|
|
`sip_trunk_report`, `phone_inventory_report`, `user_audit`,
|
|
`inbound_did_audit`, `hunt_pilot_audit`, `whoami`.
|
|
|
|
### Engineering rigor
|
|
|
|
- **Read-only by structural guarantee**: no AXL write methods are
|
|
registered; the SQL validator rejects non-SELECT/WITH queries as
|
|
defense-in-depth.
|
|
- **Hamilton-style review closed**: 7 findings (2 Critical, 3 Major,
|
|
2 Minor) addressed during pre-release hardening, each with a
|
|
regression test.
|
|
- **Live-cluster verified**: every tool path verified against a
|
|
production CUCM 15.0.1.12900 cluster before release.
|
|
- **155 unit tests**, schema drift guard for all 71 known
|
|
`fkcallingsearchspace_*` columns (via
|
|
`test_complete_schema_coverage_against_known_columns`).
|
|
|
|
### Known limitations
|
|
|
|
- `route_translation_chain` evaluates CUCM wildcards (`X`, `!`,
|
|
`[0-9]`, `@`, `\\+`) but does not model route-filter constraints on
|
|
`@` patterns — use as guidance, not authoritative.
|
|
- AXL WSDL must be supplied externally (Cisco-licensed; not bundled).
|
|
See `README.md` for bootstrap instructions.
|
|
- RisPort `state_info` cursor pagination is implemented but not yet
|
|
stress-tested on clusters with > 1000 devices in a single class.
|
|
|
|
### Acknowledgments
|
|
|
|
Borrowed two ideas from
|
|
[`@calltelemetry/cisco-cucm-mcp`](https://github.com/calltelemetry/cisco-cucm-mcp)
|
|
(MIT licensed): the RisPort70 SOAP envelope shape and the
|
|
exponential-backoff retry policy on HTTP 503. Their tool covers
|
|
operational debugging (logs, perfmon, packet capture) — install both
|
|
side-by-side for compound questions like *"audit found CSS X
|
|
unreferenced AND RisPort confirms zero phones registered against it."*
|