核心MCP服务器

基于角色环境变量的动态代理服务器策略，提供使用AWS MCP服务器的起点。

功能

规划与编排

• 提供工具以快速理解并转换到AWS服务

动态代理服务器策略

核心MCP服务器实现了一种代理服务器策略，该策略根据角色环境变量动态导入和代理其他MCP服务器。这使得您可以针对特定用例或角色创建定制的服务器配置，而无需手动配置每个服务器。

基于角色的服务器配置

您可以通过设置环境变量来启用特定的角色。每个角色对应一组通常一起使用的MCP服务器，这些服务器用于特定的用例。

重要：环境变量名称可以是小写带连字符或大写带下划线（例如，aws-foundation 或 AWS_FOUNDATION）。某些系统可能不支持带连字符的格式，请选择适合您环境的格式。

角色环境变量	描述	包含的MCP服务器
aws-foundation	AWS知识和API服务器	aws-knowledge-server, aws-api-server
dev-tools	开发工具	git-repo-research-server, code-doc-gen-server, aws-knowledge-server
ci-cd-devops	CI/CD和DevOps	cdk-server, cfn-server
container-orchestration	容器管理	eks-server, ecs-server, finch-server
serverless-architecture	无服务器开发	serverless-server, lambda-tool-server, stepfunctions-tool-server, sns-sqs-server
analytics-warehouse	数据分析和仓库	redshift-server, timestream-for-influxdb-server, dataprocessing-server, syntheticdata-server
data-platform-eng	数据平台工程	dynamodb-server, s3-tables-server, dataprocessing-server
frontend-dev	前端开发	frontend-server, nova-canvas-server
solutions-architect	解决方案架构	diagram-server, pricing-server, cost-explorer-server, syntheticdata-server, aws-knowledge-server
finops	财务运营	cost-explorer-server, pricing-server, cloudwatch-server, billing-cost-management-server
monitoring-observability	监控和可观测性	cloudwatch-server, cloudwatch-appsignals-server, prometheus-server, cloudtrail-server
caching-performance	缓存和性能	elasticache-server, memcached-server
security-identity	安全和身份	iam-server, support-server, well-architected-security-server
sql-db-specialist	SQL数据库专家	postgres-server, mysql-server, aurora-dsql-server, redshift-server
nosql-db-specialist	NoSQL数据库专家	dynamodb-server, documentdb-server, keyspaces-server, neptune-server
timeseries-db-specialist	时间序列数据库专家	timestream-for-influxdb-server, prometheus-server, cloudwatch-server
messaging-events	消息和事件	sns-sqs-server, mq-server
healthcare-lifesci	医疗和生命科学	healthomics-server

动态代理服务器策略的好处

• 简化配置：通过一个环境变量启用多个服务器
• 减少重复：即使多个角色需要，服务器也只会被导入一次
• 定制体验：为特定用例创建自定义服务器配置
• 灵活部署：轻松在不同的服务器配置之间切换

使用说明

• 如果没有启用任何角色，核心MCP服务器仍会提供其基本功能（prompt_understanding），但不会导入任何额外的服务器
• 您可以同时启用多个角色以创建全面的服务器配置
• 代理策略确保每个服务器只被导入一次，即使它被多个角色所需

注意：并非所有AWS MCP服务器都在这些逻辑分组中表示。对于特定用例，您可能需要直接安装额外的MCP服务器。请参阅主要README获取可用MCP服务器的完整列表。

先决条件

• Python 3.12或更高版本
• uv - 快速Python包安装程序和解析器
• 配置具有Bedrock访问权限的AWS凭证
• Node.js（用于UVX安装支持）

安装

Cursor	VS Code

在您的MCP客户端配置中配置MCP服务器（例如，对于Amazon Q Developer CLI，编辑~/.aws/amazonq/mcp.json）：

{
  "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
    }
  }
}

要启用特定角色的服务器配置，请在MCP客户端配置的env部分添加相应的环境变量。例如，上述配置启用了aws-foundation和solutions-architect角色，这将导入对应的MCP服务器。

Windows安装

对于Windows用户，MCP服务器配置格式略有不同：

{
  "mcpServers": {
    "awslabs.core-mcp-server": {
      "disabled": false,
      "timeout": 120,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.core-mcp-server@latest",
        "awslabs.core-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_PROFILE": "your-aws-profile",
        "AWS_REGION": "us-east-1",
        "aws-foundation": "true",
        "solutions-architect": "true"
        // 根据需要添加其他角色
      }
    }
  }
}

或者，在成功执行docker build -t awslabs/core-mcp-server .后使用docker：

  {
    "mcpServers": {
      "awslabs.core-mcp-server": {
        "command": "docker",
        "args": [
          "run",
          "--rm",
          "--interactive",
          "--env",
          "FASTMCP_LOG_LEVEL=ERROR",
          "--env",
          "aws-foundation=true",
          "--env",
          "solutions-architect=true",
          "awslabs/core-mcp-server:latest"
        ],
        "env": {},
        "disabled": false,
        "autoApprove": []
      }
    }
  }

工具和资源

服务器通过MCP接口提供了以下工具：

• prompt_understanding - 在构建给定提示的AWS解决方案时提供指导和支持