8000 feat: add cloudwatch-appsignals-mcp-server with initial tools by yiyuan-he · Pull Request #619 · awslabs/mcp · GitHub
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

feat: add cloudwatch-appsignals-mcp-server with initial tools #619

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 14 commits into
base: main
Choose a base branch
from

Conversation

yiyuan-he
Copy link

Summary

This PR introduces the CloudWatch Application Signals MCP Server, which provides tools for monitoring and analyzing AWS services using AWS Application Signals.

This is the first of two PRs, establishing the core infrastructure and initial tools.

Changes

New MCP Server Added:

  • cloudwatch-appsignals-mcp-server - Enables AI assistants to interact with AWS Application Signals

Initial Tools Implemented (2 of 7):

  • list_monitored_services - Lists all services monitored by AWS Application Signals
  • get_service_detail - Gets detailed information about a specific service including metrics and log groups

User experience

Before: Users had no programmatic way for AI assistants to interact with AWS Application Signals data. Monitoring service health,
checking SLOs, and investigating issues required manual console access.

After: AI assistants (Claude, GitHub Copilot, Amazon Q) can now:

  • List and discover all monitored services in their AWS environment
  • Get detailed service information including available metrics, dimensions, and associated log groups
  • Understand service deployment context (EKS, Lambda, ECS, etc.)

Checklist

If your change doesn't seem to apply, please leave them unchecked.

  • I have reviewed the contributing guidelines
  • I have performed a self-review of this change
  • Changes have been tested
  • Changes are documented

Is this a breaking change? (Y/N) N

RFC issue number:
#604

Checklist:

  • Migration process documented
  • Implement warnings (if it can live side by side)

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of the project license.

@yiyuan-he yiyuan-he requested review from a team as code owners June 18, 2025 21:02
@yiyuan-he yiyuan-he changed the title initial commit: cloudwatch-appsignals-mcp-server feat: add cloudwatch-appsignals-mcp-server with initial tools Jun 18, 2025
Copy link
codecov bot commented Jun 18, 2025

Codecov Report

Attention: Patch coverage is 75.71429% with 34 lines in your changes missing coverage. Please review.

Project coverage is 86.65%. Comparing base (f57e12b) to head (c5e5336).

Files with missing lines Patch % Lines
...awslabs/cloudwatch_appsignals_mcp_server/server.py 75.53% 26 Missing and 8 partials ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main     #619      +/-   ##
==========================================
- Coverage   86.71%   86.65%   -0.06%     
==========================================
  Files         401      403       +2     
  Lines       26638    26778     +140     
  Branches     4158     4176      +18     
==========================================
+ Hits        23099    23205     +106     
- Misses       2348     2374      +26     
- Partials     1191     1199       +8     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@alexa-perlov alexa-perlov added new mcp server A new MCP server ideally linked to an issue hold-merging Signals to hold the PR from merging labels Jun 18, 2025
@github-advanced-security
Copy link

This pull request sets up GitHub code scanning for this repository. Once the scans have completed and the checks have passed, the analysis results for this pull request branch will appear on this overview. Once you merge this pull request, the 'Security' tab will show more code scanning analysis results (for example, for the default branch). Depending on your configuration and choice of analysis tool, future pull requests will be annotated with code scanning analysis results. For more information about GitHub code scanning, check out the documentation.

@alexa-perlov alexa-perlov self-assigned this Jun 20, 2025
- View available CloudWatch metrics
- Find associated log groups

## Installation
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can you add a cursor deeplink install button (https://docs.cursor.com/deeplinks#generate-install-link)

8000

# Initialize AWS clients with logging
try:
logs_client = boto3.client('logs', region_name=AWS_REGION)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

consider using user_agent_extra for boto3 client



@mcp.tool()
async def get_service_detail(service_name: str) -> str:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can you use Pydantic Field() to the args? i.e. service_name: str = Field(..., description="...")

@alexa-perlov
Copy link
Contributor

A few documentation asks – can you please:

@yiyuan-he
Copy link
Author

Thanks for your review @alexa-perlov! Pushed a commit to address all your previous comments and doc updates.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
hold-merging Signals to hold the PR from merging new mcp server A new MCP server ideally linked to an issue
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants
0