AWS Labs Core MCP Server
io.github.awslabs/core-mcp-server
Overview
Deprecated AWS Labs Core MCP server for prompt understanding and role-based proxy orchestration of AWS MCP server groups.
Documentation
Overview
Core MCP Server is a deprecated AWS Labs MCP server that provides a prompt-understanding tool and a role-based dynamic proxy strategy for importing groups of other AWS MCP servers. The package README says modern clients such as Kiro, Cursor, and VS Code support multi-server configurations natively, so users should configure individual MCP servers directly instead of using this proxy/orchestration server.
Wardn's source importer was called first for https://github.com/awslabs/mcp with subfolder src/core-mcp-server, but it returned 404 (source metadata could not be loaded). Current GitHub main and the published docs URL no longer contain src/core-mcp-server; the available official artifact is the PyPI package awslabs.core-mcp-server version 1.0.27, whose source distribution contains the README, pyproject, source, Dockerfile, changelog, and tests reviewed for this submission.
Install and launch
The documented default launch uses uvx over stdio:
{
"mcpServers": {
"awslabs-core-mcp-server": {
"command": "uvx",
"args": ["awslabs.core-mcp-server@latest"],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR",
"aws-foundation": "true",
"solutions-architect": "true"
},
"autoApprove": [],
"disabled": false
}
}
}
The submitted default keeps every role disabled by default and launches uvx awslabs.core-mcp-server@latest with FASTMCP_LOG_LEVEL=ERROR.
For Windows, the README documents uv tool run --from awslabs.core-mcp-server@latest awslabs.core-mcp-server.exe with optional AWS_PROFILE, AWS_REGION, and role variables. The README also documents building a Docker image with docker build -t awslabs/core-mcp-server . and running it via docker run --rm --interactive --env FASTMCP_LOG_LEVEL=ERROR ... awslabs/core-mcp-server:latest.
Configuration
Role flags enable groups of proxied MCP servers. The README and source both note that role variables can be lowercase with hyphens or uppercase with underscores. Empty or unset values leave the role disabled.
aws-foundation/AWS_FOUNDATION: AWS knowledge and API servers; imports aws-knowledge-server, aws-api-server.dev-tools/DEV_TOOLS: Development tools; imports git-repo-research-server, code-doc-gen-server, aws-knowledge-server.ci-cd-devops/CI_CD_DEVOPS: CI/CD and DevOps; imports cdk-server, cfn-server.container-orchestration/CONTAINER_ORCHESTRATION: Container management; imports eks-server, ecs-server, finch-server.serverless-architecture/SERVERLESS_ARCHITECTURE: Serverless development; imports serverless-server, lambda-tool-server, stepfunctions-tool-server, sns-sqs-server.analytics-warehouse/ANALYTICS_WAREHOUSE: Data analytics and warehousing; imports redshift-server, timestream-for-influxdb-server, dataprocessing-server, syntheticdata-server.data-platform-eng/DATA_PLATFORM_ENG: Data platform engineering; imports dynamodb-server, s3-tables-server, dataprocessing-server.frontend-dev/FRONTEND_DEV: Frontend development; imports frontend-server, nova-canvas-server.solutions-architect/SOLUTIONS_ARCHITECT: Solution architecture; imports diagram-server, pricing-server, cost-explorer-server, syntheticdata-server, aws-knowledge-server.finops/FINOPS: Financial operations; imports cost-explorer-server, pricing-server, cloudwatch-server, billing-cost-management-server.monitoring-observability/MONITORING_OBSERVABILITY: Monitoring and observability; imports cloudwatch-server, cloudwatch-appsignals-server, prometheus-server, cloudtrail-server.caching-performance/CACHING_PERFORMANCE: Caching and performance; imports elasticache-server, memcached-server.security-identity/SECURITY_IDENTITY: Security and identity; imports iam-server, support-server, well-architected-security-server.sql-db-specialist/SQL_DB_SPECIALIST: SQL database specialist; imports postgres-server, mysql-server, aurora-dsql-server, redshift-server.nosql-db-specialist/NOSQL_DB_SPECIALIST: NoSQL database specialist; imports dynamodb-server, documentdb-server, keyspaces-server, neptune-server.timeseries-db-specialist/TIMESERIES_DB_SPECIALIST: Time series database specialist; imports timestream-for-influxdb-server, prometheus-server, cloudwatch-server.messaging-events/MESSAGING_EVENTS: Messaging and events; imports sns-sqs-server, mq-server.healthcare-lifesci/HEALTHCARE_LIFESCI: Healthcare and life sciences; imports healthomics-server.
FASTMCP_LOG_LEVEL is the documented FastMCP log-level variable. AWS_PROFILE and AWS_REGION are documented in the Windows launch and are inherited by proxied AWS MCP servers. The source also proxies AWS Knowledge through mcp-proxy --transport streamablehttp https://knowledge-mcp.global.api.aws when relevant roles are enabled.
Tool
The server exposes one built-in tool:
prompt_understanding: returns static AWS architecture guidance fromstatic/PROMPT_UNDERSTANDING.mdto help translate a user prompt into AWS service and MCP server guidance.
Enabled roles can import additional tools from proxied MCP servers. If no roles are enabled, only prompt_understanding is available.
Prerequisites
- Python 3.10+ per package metadata; the README says Python 3.12 or higher.
- uv for the documented
uvxlaunch. - Node.js for UVX installation support per README.
- AWS credentials with Bedrock access per README and any credentials required by the proxied AWS MCP servers for enabled roles.
- Modern MCP clients should prefer direct multi-server configuration instead of this deprecated proxy.
Limitations and deprecation notes
This server is deprecated and will no longer receive updates. The migration guide says it was deprecated because modern MCP clients support multi-server configs natively, the package has a large dependency footprint, proxied tool names can exceed a 64-character API limit in some clients, and the core bundle includes some deprecated servers. The current GitHub main branch and hosted docs URL return 404 for core-mcp-server; PyPI still publishes version 1.0.27. The changelog says Server-Sent Events support was removed in 1.0.0, so stdio is the documented active transport. Role imports may fail if an included server or dependency is unavailable; the source logs import failures and continues.
Wardn source and version note
This registry entry uses server version 1.0.0; the reviewed runnable PyPI package artifact is awslabs.core-mcp-server version 1.0.27. Upstream README examples use @latest, but this submitted package launch is pinned to uvx [email protected] so it runs the reviewed artifact. The historical GitHub subfolder src/core-mcp-server no longer resolves on current awslabs/mcp main, so source review treats the PyPI sdist https://files.pythonhosted.org/packages/70/fb/871efc6f8374597dd8d2bd8c68be52e89967aadaf2345bf9e4dc5179d706/awslabs_core_mcp_server-1.0.27.tar.gz as authoritative.
The README and server.py support uppercase underscore aliases for role environment variables, for example aws-foundation and AWS_FOUNDATION; this alias behavior is documented in source review notes rather than as a fake aggregate environment variable.