{"library":"mcp-proxy-for-aws","title":"MCP Proxy for AWS","description":"The MCP Proxy for AWS is a Python library that serves as a lightweight, client-side bridge between Model Context Protocol (MCP) clients (such as AI assistants and developer tools) and IAM-secured MCP servers on AWS. It handles SigV4 authentication using local AWS credentials and provides dynamic tool discovery. The library is currently at version 1.3.0 and is actively maintained, with updates released as needed to support AWS services and the MCP specification.","language":"python","status":"active","last_verified":"Sun May 17","install":{"commands":["pip install mcp-proxy-for-aws"],"cli":null},"imports":["from mcp_proxy_for_aws.mcp_proxy import McpProxy","from mcp_proxy_for_aws.server import run_server"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nfrom mcp_proxy_for_aws.mcp_proxy import McpProxy\n\n# Ensure AWS credentials and region are configured (e.g., via environment variables or ~/.aws/credentials)\n# For programmatic use, you might explicitly pass them, but for quickstart, rely on boto3's default chain.\naws_region = os.environ.get('AWS_REGION', 'us-east-1')\nmcp_endpoint_url = os.environ.get('MCP_ENDPOINT_URL', 'https://your-mcp-server.amazonaws.com/mcp')\n\ntry:\n    # Initialize the MCP Proxy client\n    proxy_client = McpProxy(endpoint=mcp_endpoint_url, region=aws_region)\n    print(f\"Initialized MCP Proxy for endpoint: {mcp_endpoint_url}\")\n\n    # Example: Discover tools (this would typically involve calling a method that hits the MCP server)\n    # Note: The actual method for tool discovery might vary based on the MCP server implementation.\n    # This is a placeholder for demonstrating client initialization.\n    print(\"Attempting to discover tools (requires a live MCP server)...\")\n    # In a real scenario, you'd call methods like proxy_client.discover_tools() if available\n    # or integrate with an AI agent framework.\n    print(\"MCP Proxy client initialized successfully. Ready for agent integration.\")\n\nexcept Exception as e:\n    print(f\"Error initializing MCP Proxy: {e}\")\n    print(\"Please ensure 'MCP_ENDPOINT_URL' and AWS credentials/region are correctly configured.\")\n","lang":"python","description":"This quickstart demonstrates how to programmatically initialize the `McpProxy` client. It assumes AWS credentials (e.g., `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_REGION`) and the `MCP_ENDPOINT_URL` environment variable are set. The client handles SigV4 authentication automatically using the default boto3 credential chain.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-17","installed_version":"1.4.2","pypi_latest":"1.4.2","is_stale":false,"summary":{"python_range":"3.10–3.9","success_rate":80,"avg_install_s":15,"avg_import_s":null,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"mcp-proxy-for-aws","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"155.9M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"mcp-proxy-for-aws","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":17.7,"import_time_s":null,"mem_mb":null,"disk_size":"156M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"mcp-proxy-for-aws","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"168.3M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"mcp-proxy-for-aws","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":16.3,"import_time_s":null,"mem_mb":null,"disk_size":"168M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"mcp-proxy-for-aws","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"157.5M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"mcp-proxy-for-aws","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":13,"import_time_s":null,"mem_mb":null,"disk_size":"158M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"mcp-proxy-for-aws","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":"157.3M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"mcp-proxy-for-aws","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":13,"import_time_s":null,"mem_mb":null,"disk_size":"157M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"mcp-proxy-for-aws","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"mcp-proxy-for-aws","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":1.7,"import_time_s":null,"mem_mb":null,"disk_size":null}]}}