feat(cloudwatch-appsignals-mcp-server): add deprecation notices#2711
feat(cloudwatch-appsignals-mcp-server): add deprecation notices#2711MichaelWalker-git wants to merge 2 commits intomainfrom
Conversation
Add standard deprecation pattern for cloudwatch-appsignals-mcp-server in favor of cloudwatch-applicationsignals-mcp-server. - Add DEPRECATION_NOTICE constant and prepend to FastMCP instructions - Add FutureWarning in main() to alert users at startup - Add [DEPRECATED] prefix to all 13 tool docstrings - Fix existing per-tool warnings: DeprecationWarning -> FutureWarning, stacklevel 1 -> 2
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## main #2711 +/- ##
==========================================
- Coverage 91.28% 91.26% -0.02%
==========================================
Files 1015 1015
Lines 76261 76263 +2
Branches 12393 12393
==========================================
- Hits 69612 69603 -9
- Misses 4058 4065 +7
- Partials 2591 2595 +4 ☔ View full report in Codecov by Sentry. 🚀 New features to boost your workflow:
|
There was a problem hiding this comment.
Pull request overview
This PR adds deprecation signaling to cloudwatch-appsignals-mcp-server to steer users toward the replacement cloudwatch-applicationsignals-mcp-server, using server-level instructions, startup warnings, and tool-level docstring labeling.
Changes:
- Introduces a shared
DEPRECATION_NOTICEand surfaces it via FastMCPinstructionsplus aFutureWarningemitted at startup (main()). - Prepends
[DEPRECATED]to tool docstrings across the server and tool modules. - Updates tests to tolerate/verify the new startup deprecation warning.
Reviewed changes
Copilot reviewed 5 out of 5 changed files in this pull request and generated 10 comments.
Show a summary per file
| File | Description |
|---|---|
| src/cloudwatch-appsignals-mcp-server/awslabs/cloudwatch_appsignals_mcp_server/server.py | Adds DEPRECATION_NOTICE, surfaces it in FastMCP instructions, switches several warnings to FutureWarning, and emits a startup warning in main(). |
| src/cloudwatch-appsignals-mcp-server/awslabs/cloudwatch_appsignals_mcp_server/service_tools.py | Marks service tools as [DEPRECATED] via docstrings. |
| src/cloudwatch-appsignals-mcp-server/awslabs/cloudwatch_appsignals_mcp_server/slo_tools.py | Marks SLO tools as [DEPRECATED] via docstrings. |
| src/cloudwatch-appsignals-mcp-server/awslabs/cloudwatch_appsignals_mcp_server/trace_tools.py | Marks trace tools as [DEPRECATED] via docstrings. |
| src/cloudwatch-appsignals-mcp-server/tests/test_server.py | Adjusts main() tests to ignore warnings and adds a new test asserting a deprecation FutureWarning is emitted. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
src/cloudwatch-appsignals-mcp-server/awslabs/cloudwatch_appsignals_mcp_server/service_tools.py
Show resolved
Hide resolved
src/cloudwatch-appsignals-mcp-server/awslabs/cloudwatch_appsignals_mcp_server/service_tools.py
Show resolved
Hide resolved
src/cloudwatch-appsignals-mcp-server/awslabs/cloudwatch_appsignals_mcp_server/slo_tools.py
Show resolved
Hide resolved
src/cloudwatch-appsignals-mcp-server/awslabs/cloudwatch_appsignals_mcp_server/trace_tools.py
Show resolved
Hide resolved
src/cloudwatch-appsignals-mcp-server/awslabs/cloudwatch_appsignals_mcp_server/trace_tools.py
Show resolved
Hide resolved
src/cloudwatch-appsignals-mcp-server/awslabs/cloudwatch_appsignals_mcp_server/service_tools.py
Show resolved
Hide resolved
src/cloudwatch-appsignals-mcp-server/awslabs/cloudwatch_appsignals_mcp_server/service_tools.py
Show resolved
Hide resolved
src/cloudwatch-appsignals-mcp-server/awslabs/cloudwatch_appsignals_mcp_server/slo_tools.py
Show resolved
Hide resolved
src/cloudwatch-appsignals-mcp-server/awslabs/cloudwatch_appsignals_mcp_server/trace_tools.py
Show resolved
Hide resolved
Fix DeprecationWarning -> FutureWarning and stacklevel=1 -> stacklevel=2 in service_tools.py (4), slo_tools.py (2), and trace_tools.py (3).
|
Closing — PR #2173 already merged and removed the cloudwatch-appsignals-mcp-server from main, making these deprecation notices moot. The server has been superseded by cloudwatch-applicationsignals-mcp-server. |
Summary
DEPRECATION_NOTICEconstant and prepend to FastMCP instructionsFutureWarninginmain()to alert users at startup[DEPRECATED]prefix to all 13 tool docstrings (server.py, service_tools.py, slo_tools.py, trace_tools.py)DeprecationWarning→FutureWarning,stacklevel=1→stacklevel=2This addresses the long-standing request from the ApplicationSignals team (since Dec 2025) to deprecate the old
cloudwatch-appsignals-mcp-serverin favor ofcloudwatch-applicationsignals-mcp-server.Test plan
test_main_emits_deprecation_warningverifies FutureWarning is emittedBy submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of the project license.