Cost Explorer MCP Server

# Cost Explorer MCP Server - AgentCore Runtime Deployment Summary ## ✅ Successfully Completed ### 1. Local MCP Server Development - ✅ **Converted STDIO to Streamable HTTP**: Successfully converted the original cost-explorer-mcp-server from STDIO to streamable HTTP transport - ✅ **Local Testing**: Both simple and complex MCP servers work perfectly locally on port 8000 - ✅ **MCP Protocol Compliance**: Servers follow MCP specification with proper tool registration and streamable HTTP transport ### 2. AgentCore Runtime Deployment - ✅ **AgentCore CLI Setup**: Successfully installed and configured bedrock-agentcore-starter-toolkit - ✅ **MCP Server Deployment**: Successfully deployed MCP servers to AgentCore Runtime - ✅ **Infrastructure Creation**: Auto-created IAM roles, S3 buckets, and memory resources - ✅ **Agent Status**: Agents show as "READY" in AgentCore Runtime ### 3. Deployment Artifacts - ✅ **Simple MCP Server**: `arn:aws:bedrock-agentcore:us-west-2:632930644527:runtime/simple_mcp_server-5gCG6jAMaP` - ✅ **Cost Explorer MCP Server**: `arn:aws:bedrock-agentcore:us-west-2:632930644527:runtime/agentcore_mcp_server-IZBGEpHspW` - ✅ **Configuration Files**: Proper `.bedrock_agentcore.yaml` configuration with MCP protocol - ✅ **Requirements**: All dependencies properly packaged and deployed ## 🔄 Current Status: Authentication Required ### The Challenge The MCP servers are successfully deployed and running on AgentCore Runtime, but **authentication is required** to access them remotely. This is expected behavior for production deployments. ### What's Working 1. **Local MCP Servers**: Perfect functionality with all 7 Cost Explorer tools 2. **AgentCore Deployment**: Successful deployment with proper MCP protocol configuration 3. **Infrastructure**: All AWS resources created and configured correctly ### What's Needed: OAuth Authentication Setup According to AWS documentation, accessing deployed MCP servers requires OAuth authentication. The next steps are: ## 📋 Next Steps for Production Use ### Option 1: Cognito User Pool Authentication (Recommended) ```bash # Set up Cognito User Pool as described in AWS docs export REGION=us-west-2 export USERNAME=testuser export PASSWORD=MyPassword123! # Run the Cognito setup script from AWS documentation source setup_cognito.sh # Use the Bearer token for MCP client authentication export AGENT_ARN="arn:aws:bedrock-agentcore:us-west-2:632930644527:runtime/simple_mcp_server-5gCG6jAMaP" export BEARER_TOKEN="your-cognito-access-token" python test_agentcore_mcp_client.py ``` ### Option 2: Auth0 OAuth Setup Follow the Auth0 setup instructions in the AWS documentation for more advanced OAuth flows. ## 🎯 Current Deployment Status ### Simple MCP Server (Working Example) - **ARN**: `arn:aws:bedrock-agentcore:us-west-2:632930644527:runtime/simple_mcp_server-5gCG6jAMaP` - **Tools**: `add_numbers`, `multiply_numbers`, `greet_user` - **Status**: ✅ Deployed and Ready - **Protocol**: MCP with Streamable HTTP on port 8000 ### Cost Explorer MCP Server (Full Implementation) - **ARN**: `arn:aws:bedrock-agentcore:us-west-2:632930644527:runtime/agentcore_mcp_server-IZBGEpHspW` - **Tools**: All 7 Cost Explorer tools (get_today_date, get_dimension_values, etc.) - **Status**: ✅ Deployed and Ready - **Protocol**: MCP with Streamable HTTP on port 8000 ## 🔧 Technical Implementation Details ### MCP Server Configuration ```yaml protocol_configuration: server_protocol: MCP ``` ### Endpoint Structure ``` https://bedrock-agentcore.us-west-2.amazonaws.com/runtimes/{encoded_arn}/invocations?qualifier=DEFAULT ``` ### Local Testing Commands ```bash # Test locally (works perfectly) python mcp_server.py # Start server python test_mcp_client.py # Test client # Test simple server locally python simple_mcp_server.py # Start simple server python test_simple_mcp.py # Test simple client ``` ## 📚 References - [AWS AgentCore MCP Documentation](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-mcp.html) - [MCP Protocol Specification](https://modelcontextprotocol.io/) - [AgentCore Starter Toolkit](https://aws.github.io/bedrock-agentcore-starter-toolkit/) ## 🎉 Achievement Summary We have successfully: 1. ✅ **Converted** the Cost Explorer MCP server from STDIO to streamable HTTP 2. ✅ **Deployed** both simple and complex MCP servers to AgentCore Runtime 3. ✅ **Configured** proper MCP protocol support with port 8000 4. ✅ **Verified** local functionality with all 7 Cost Explorer tools 5. ✅ **Created** production-ready deployment infrastructure The MCP servers are now **ready for production use** once OAuth authentication is configured according to AWS documentation.