关于 EDGEONE-PAGES-MCP
EDGEONE-PAGES-MCP 是面向 AWS 云开发的 MCP 服务套件,供连接 MCP 的 AI 应用获取 AWS 文档与工作流支持。仓库涵盖文档、基础设施、容器、无服务器及数据等领域的专用服务,使用 stdio 传输。
主要功能
- 01访问最新 AWS 文档与 API 参考
- 02基础设施即代码指导与验证
- 03支持容器和无服务器开发
- 04覆盖数据、AI 与开发工具领域
适用场景
- 01查阅 AWS 服务文档和最佳实践
- 02规划或排查基础设施部署
- 03在 AI 开发工作流中调用 AWS 专用能力
MCP 相关
通过 MCP 向 AI 应用提供 AWS 文档、指导和工作流工具。仓库中的 MCP 服务支持 stdio 传输。
详细介绍
AWS 开源 MCP 服务
一套专用 MCP 服务,无论你在哪里使用 MCP,都能帮你充分利用 AWS。
提示
AWS Agent Toolkit现已上线!AWS Agent Toolkit 是 AWS Labs 上 MCP 服务、插件和技能的后继产品,其设计借鉴了你这样的客户提供的反馈。如果你正在使用编码 Agent 构建生产软件,或为自己的客户构建 Agent,我们推荐使用 AWS Agent Toolkit。它包含用于区分 Agent 操作与人工操作的 IAM 条件键、CloudWatch 和 CloudTrail 可见性,以及经过准确性和有效性评估的技能。本仓库将继续正常运行并接受贡献。随着时间推移,这里最有用的项目将迁移到 AWS Agent Toolkit。
目录
- AWS 开源 MCP 服务
什么是模型上下文协议(MCP),它如何与 AWS 的 MCP 服务配合使用?
模型上下文协议(MCP)是一种开放协议,可让大模型应用与外部数据源和工具无缝集成。无论你是在构建 AI 驱动的 IDE、增强聊天界面,还是创建自定义 AI 工作流,MCP 都能提供一种标准化方式,让大模型连接到所需的上下文。
MCP 服务是一种轻量级程序,通过标准化的模型上下文协议提供特定功能。宿主应用(例如聊天机器人、IDE 和其他 AI 工具)拥有 MCP 客户端,与 MCP 服务维持一对一连接。常见的 MCP 客户端包括 Agent 式 AI 编码助手(如 Kiro、Cline、Cursor、Windsurf),以及 Claude Desktop 等聊天机器人应用,未来还会有更多客户端。MCP 服务可以访问本地数据源和远程服务,为模型提供额外上下文,从而改善生成结果。
AWS 的 MCP 服务使用此协议,为 AI 应用提供 AWS 文档、情境化指导和最佳实践。通过标准化的客户端-服务架构,AWS 功能可成为开发环境或 AI 应用的智能扩展。
AWS 的 MCP 服务可增强云原生开发、基础设施管理和开发工作流,让 AI 辅助云计算更加易用、高效。
模型上下文协议是由 Anthropic, PBC. 运营的开源项目,并向整个社区开放贡献。有关 MCP 的更多信息,请参阅此处。
AWS 开源 MCP 服务的传输机制
支持的传输机制
MCP 协议目前定义了两种客户端-服务通信的标准传输机制:
- stdio,即通过标准输入和标准输出进行通信
- streamable HTTP
此代码仓库中的 MCP 服务仅支持 stdio。
你有责任确保使用这些服务时遵守相关条款,以及适用于你的任何法律、规则、法规、政策或标准。
移除服务器发送事件支持
重要通知: 2025 年 5 月 26 日,所有 MCP 服务的最新主版本均移除了服务器发送事件(SSE)支持。此变更符合模型上下文协议规范的向后兼容性指南。
我们正在积极开发对 Streamable HTTP 的支持,以便在未来版本中提供更完善的传输能力。
如果应用仍需要 SSE 支持,请继续使用相应 MCP 服务的上一主版本,直到能够迁移到其他传输方式。
为什么要使用 AWS 的 MCP 服务?
MCP 服务可通过以下几种关键方式增强基础模型(FM)的能力:
-
提升输出质量:通过将相关信息直接提供给模型作为上下文,MCP 服务可显著提升模型在 AWS 服务等专业领域的响应质量。这种方式可减少幻觉,提供更准确的技术细节,实现更精准的代码生成,并确保建议符合最新的 AWS 最佳实践和服务能力。
-
获取最新文档:基础模型可能不了解近期发布的版本、API 或 SDK。MCP 服务通过获取最新文档来弥补这一差距,确保你的 AI 助手始终使用最新的 AWS 功能。
-
工作流自动化:MCP 服务可将常见工作流转换为基础模型可直接使用的工具。无论是 CDK、Terraform,还是其他 AWS 专属工作流,这些工具都能帮助 AI 助手更准确、高效地完成复杂任务。
-
专业领域知识:MCP 服务可提供关于 AWS 服务的深入、上下文相关知识,这些知识可能未在基础模型的训练数据中得到充分体现,从而使其在云开发任务中给出更准确、更有帮助的响应。
可用 MCP 服务:快速安装
使用适用于热门 MCP 客户端的一键安装按钮快速开始。点击下方按钮,即可直接在 Cursor 或 VS Code 中安装服务:
🚀 开始使用 AWS
对于 AWS 交互,我们建议从以下服务开始:
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS MCP 服务(预览版) | 从这里开始,安全、可审计地与 AWS 交互!此远程托管 MCP 服务由 AWS 托管,兼具全面的 AWS API 支持,以及对最新 AWS 文档、API 参考资料、What's New 帖子和入门信息的访问能力。它提供预构建的 Agent SOP,遵循 AWS 最佳实践,帮助 Agent 可靠地完成复杂的多步骤 AWS 任务。该服务以安全性和可控性为设计核心:API 调用经过语法验证,基于 IAM 的权限不会暴露凭证,并提供完整的 CloudTrail 审计日志。访问所有 AWS 服务,以管理基础设施、浏览资源和执行 AWS 操作,同时确保全过程透明且可追溯。了解更多 |
按构建目标浏览
📚 实时访问 AWS 官方文档
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS Knowledge MCP Server | 由 AWS 托管的远程全托管 MCP 服务,可访问最新的 AWS 文档、API 参考、What's New 帖子、入门信息、Builder Center、博客文章、架构参考和 Well-Architected 指南。 | |
| AWS Documentation MCP Server | 获取最新的 AWS 文档和 API 参考 |
🏗️ 基础设施与部署
遵循基础设施即代码最佳实践,构建、部署和管理云基础设施。
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS IaC MCP Server | 完整的基础设施即代码工具包,可访问 CloudFormation 文档、获取 CDK 最佳实践指导、构造示例、安全验证和部署故障排查 | |
| AWS Cloud Control API MCP Server ⚠️ 已弃用 | 直接管理 AWS 资源,并提供安全扫描和最佳实践(请改用 AWS IaC MCP Server) |
容器平台
| 服务名称 | 描述 | 安装 |
|---|---|---|
| Amazon EKS MCP Server | Kubernetes 集群管理和应用部署 | |
| Amazon ECS MCP Server | 容器编排和 ECS 应用部署 | |
| Finch MCP Server | 集成本地容器构建与 ECR |
无服务器与函数
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS Serverless MCP Server | 使用 SAM CLI 管理无服务器应用程序的完整生命周期 | |
| AWS Lambda Tool MCP Server | 将 Lambda 函数作为 AI 工具执行,以访问私有资源 |
迁移与现代化
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS Transform MCP Server | 管理 AWS Transform 工作区、作业、连接器、HITL 任务和构件,支持大型机、VMware、.NET 和自定义代码转换 |
支持
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS Support MCP Server | 帮助用户创建和管理 AWS Support 案例 |
🤖 AI 与机器学习
借助知识检索、内容生成和 ML 能力增强 AI 应用
| 服务名称 | 描述 | 安装 |
|---|---|---|
| Amazon Bedrock Knowledge Bases Retrieval MCP Server | 查询企业知识库,并支持引用 | |
| Amazon Kendra Index MCP Server | 企业搜索和 RAG 增强 | |
| Amazon Q Business MCP Server | 通过匿名访问,为已摄取的内容提供 AI 助手 | |
| Amazon Q Index MCP Server | 用于搜索企业 Q 索引的数据访问器 | |
| AWS Bedrock Custom Model Import MCP Server | 管理 Bedrock 中的自定义模型,以进行按需推理 | |
| AWS Bedrock AgentCore MCP Server | 全面提供 AgentCore 平台服务、API 和最佳实践的文档访问 | |
| Amazon Translate MCP Server | 支持 75 种以上语言的神经机器翻译,具备批处理和自定义术语功能 | |
| Amazon SageMaker AI MCP Server | SageMaker AI 资源管理和模型开发 | |
| Registry of Open Data (RODA) MCP Server | 发现、浏览和预览 AWS 上的开放数据集 |
📊 数据与分析
使用数据库、缓存系统和数据处理工作流。
SQL 与 NoSQL 数据库
| 服务名称 | 描述 | 安装 |
|---|---|---|
| Amazon DynamoDB MCP Server | DynamoDB 专家设计指导和数据建模协助 | |
| Amazon Aurora PostgreSQL MCP Server | 通过 RDS Data API 执行 PostgreSQL 数据库操作 | |
| Amazon Aurora MySQL MCP Server | 通过 RDS Data API 执行 MySQL 数据库操作 | |
| Amazon Aurora DSQL MCP Server | 与 PostgreSQL 兼容的分布式 SQL | |
| Amazon DocumentDB MCP Server | 兼容 MongoDB 的文档数据库操作 | |
| Amazon Neptune MCP Server | 使用 openCypher 和 Gremlin 查询图数据库 | |
| Amazon Keyspaces MCP Server | 兼容 Apache Cassandra 的操作 | |
| Amazon Timestream for InfluxDB MCP Server | 时序数据库操作和 InfluxDB 兼容性 | |
| AWS S3 Tables MCP Server | 管理 S3 Tables,实现优化分析 | |
| Amazon Redshift MCP Server | 数据仓库操作和分析查询 | |
| Amazon RDS Oracle MCP Server | 通过 Secrets Manager 身份验证执行 Oracle Database 操作 | |
| Amazon RDS for Db2 MCP Server | 通过 Secrets Manager 身份验证执行 Amazon RDS for Db2 操作 | |
| AWS IoT SiteWise MCP Server | 工业物联网资产管理、数据摄取和分析 | |
| Amazon RDS MSSQL MCP Server | 通过 RDS Data API 执行 SQL Server 数据库操作 |
搜索与分析
- Amazon OpenSearch MCP Server - 基于 OpenSearch 的搜索、分析和可观测性
后端 API 提供商
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS AppSync MCP Server | 管理和交互由 AWS AppSync 提供支持的应用后端 |
缓存与性能
| 服务名称 | 描述 | 安装 |
|---|---|---|
| Amazon ElastiCache MCP Server | 完整的 ElastiCache 控制平面操作 | |
| Amazon ElastiCache / MemoryDB for Valkey MCP Server | 借助 Valkey 实现高级数据结构与缓存 | |
| Amazon ElastiCache for Memcached MCP Server | 使用 Memcached 协议实现高速缓存 |
开放数据
| 服务名称 | 描述 | 安装 |
|---|---|---|
| 开放数据注册表(RODA)MCP 服务 | 发现、探索和预览 AWS 上的开放数据集 |
🛠️ 开发者工具与支持
借助代码分析、文档和测试工具,加速开发。
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS IAM MCP Server | 全面的 IAM 用户、角色、组和策略管理,并遵循安全最佳实践 | |
| AWS Security Agent MCP Server | 使用 AWS Security Agent 自动执行安全扫描、渗透测试和修复 | |
| OpenAPI MCP Server | 通过 OpenAPI 规范动态集成 API |
📡 集成与消息传递
通过消息传递、工作流和位置服务连接系统。
| 服务名称 | 描述 | 安装 |
|---|---|---|
| Amazon SNS / SQS MCP Server | 事件驱动的消息传递和队列管理 | |
| Amazon MQ MCP Server | RabbitMQ 和 ActiveMQ 的消息代理管理 | |
| AWS Step Functions Tool MCP Server | 执行复杂工作流和业务流程 | |
| Amazon Location Service MCP Server | 地点搜索、地理编码和路线优化 | |
| OpenAPI MCP Server | 通过 OpenAPI 规范动态集成 API |
💰 成本与运营
监控、优化和管理您的 AWS 基础设施及成本。
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS Pricing MCP Server | AWS 服务定价和成本估算 | |
| Amazon CloudWatch MCP Server | 指标、警报和日志分析及运维故障排查 | |
| AWS Managed Prometheus MCP Server | 兼容 Prometheus 的运维操作 | |
| AWS Billing and Cost Management MCP Server | 可计费账单和 Proforma 账单的账单与成本管理 |
🧬 医疗与生命科学
与 AWS HealthAI 服务交互。
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS HealthOmics MCP Server | 生成、运行、调试和优化生命科学工作流 | |
| AWS HealthImaging MCP Server | 全面的医学影像数据生命周期管理,提供 21 个用于 DICOM 操作、数据存储管理和自动发现的工具 | |
| AWS HealthLake MCP Server | 通过全面的 AWS HealthLake 集成,创建、管理、搜索和优化 FHIR 医疗数据工作流,支持自动资源发现、高级搜索功能、患者记录管理以及无缝导入/导出操作。 | |
| Registry of Open Data (RODA) MCP Server | 发现、浏览和预览 AWS 上的开放数据集 |
按工作方式浏览
👨💻 氛围编程与开发
Kiro、Cline、Cursor 和 Claude Code 等 AI 编码助手,助你更快完成构建
研习坊:查看 使用 AWS MCP 服务进行氛围编程研习坊,获取实践指导和示例。
核心开发工作流
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS API MCP Server | 从这里开始进行常规 AWS 交互!全面支持 AWS API,并提供命令验证、安全控制以及对所有 AWS 服务的访问。非常适合通过自然语言管理基础设施、探索资源和执行 AWS 操作。 | |
| AWS Knowledge MCP Server | 由 AWS 托管的远程全托管 MCP 服务,可访问最新的 AWS 文档、API 参考资料、What's New 帖子、入门信息、Builder Center、博客文章、架构参考资料以及 Well-Architected 指南。 | |
| AWS Documentation MCP Server | 获取最新的 AWS 文档和 API 参考资料 |
基础设施即代码
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS IaC MCP Server | 完整的基础设施即代码工具包,支持访问 CloudFormation 文档、获取 CDK 最佳实践指导、查看构造示例、安全验证和部署故障排查 | |
| AWS Cloud Control API MCP Server ⚠️ 已弃用 | 直接管理 AWS 资源,并提供安全扫描和最佳实践(请改用 AWS IaC MCP Server) |
应用开发
| 服务名称 | 描述 | 安装 |
|---|---|---|
| OpenAPI MCP Server | 通过 OpenAPI 规范实现动态 API 集成 |
容器与无服务器开发
| 服务名称 | 描述 | 安装 |
|---|---|---|
| Amazon SageMaker AI MCP Server | SageMaker AI 资源管理和模型开发 | |
| Amazon EKS MCP Server | Kubernetes 集群管理和应用部署 | |
| Amazon ECS MCP Server | 将应用容器化并部署到 ECS | |
| Finch MCP Server | 在本地构建容器并推送到 ECR | |
| AWS Serverless MCP Server | 使用 SAM CLI 管理无服务器应用的完整生命周期 |
测试与数据
| 服务名称 | 描述 | 安装 |
|---|
生命科学工作流开发
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS HealthOmics MCP 服务 | 生成、运行、调试和优化生命科学工作流 |
医疗保健数据管理
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS HealthLake MCP 服务 | 通过全面的 AWS HealthLake 集成,创建、管理、搜索和优化 FHIR 医疗保健数据工作流,支持自动发现资源、高级搜索功能、患者记录管理以及无缝导入/导出操作。 |
💬 对话式助手
面向客户的聊天机器人、业务 Agent 和交互式问答系统
知识与搜索
| 服务名称 | 描述 | 安装 |
|---|---|---|
| Amazon Bedrock Knowledge Bases Retrieval MCP Server | 查询企业知识库,并支持引用 | |
| Amazon Kendra Index MCP Server | 企业搜索与 RAG 增强 | |
| Amazon Q Business MCP Server | 可匿名访问已摄取内容的 AI 助手 | |
| Amazon Q Index MCP Server | 用于搜索企业 Q 索引的数据访问器 | |
| AWS Documentation MCP Server | 获取最新 AWS 文档和 API 参考 |
内容处理与生成
| 服务名称 | 描述 | 安装 |
|---|---|---|
| Document Loader MCP Server | 解析并提取 PDF、DOCX、XLSX、PPTX 和图像文件中的内容 | |
| Amazon Translate MCP Server | 支持 75 种以上语言的神经机器翻译,提供批量处理和自定义术语功能 |
商业服务
| 服务名称 | 描述 | 安装 |
|---|---|---|
| Amazon Location Service MCP Server | 地点搜索、地理编码和营业时间 | |
| AWS Pricing MCP Server | AWS 服务定价和成本估算 |
🤖 自主后台 Agent
无头自动化、ETL 管道和运营系统
数据运营与 ETL
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS Data Processing MCP 服务 | 提供全面的数据处理工具,并支持跨 AWS Glue、Amazon EMR-EC2 和 Amazon Athena 实时查看管道状态 | |
| Amazon DynamoDB MCP 服务 | 提供完整的 DynamoDB 操作和表管理功能 | |
| Amazon Aurora PostgreSQL MCP 服务 | 通过 RDS Data API 执行 PostgreSQL 数据库操作 | |
| Amazon Aurora MySQL MCP 服务 | 通过 RDS Data API 执行 MySQL 数据库操作 | |
| Amazon Aurora DSQL MCP 服务 | 兼容 PostgreSQL 的分布式 SQL | |
| Amazon DocumentDB MCP 服务 | 兼容 MongoDB 的文档数据库操作 | |
| Amazon Neptune MCP 服务 | 使用 openCypher 和 Gremlin 查询图数据库 | |
| Amazon Keyspaces MCP 服务 | 兼容 Apache Cassandra 的操作 | |
| Amazon Timestream for InfluxDB MCP 服务 | 时序数据库操作及 InfluxDB 兼容性 | |
| Amazon RDS MSSQL MCP 服务 | 通过 RDS Data API 执行 SQL Server 数据库操作 | |
| Amazon RDS Oracle MCP 服务 | 通过 Secrets Manager 身份验证执行 Oracle Database 操作 | |
| Amazon RDS for Db2 MCP 服务 | 通过 Secrets Manager 身份验证执行 Amazon RDS for Db2 操作 |
缓存与性能
| 服务名称 | 描述 | 安装 |
|---|---|---|
| Amazon ElastiCache / MemoryDB for Valkey MCP Server | 使用 Valkey 实现高级数据结构和缓存 | |
| Amazon ElastiCache for Memcached MCP Server | 使用 Memcached 协议实现高速缓存 |
工作流与集成
| 服务名称 | 描述 | 安装 |
|---|---|---|
| AWS Lambda Tool MCP Server | 将 Lambda 函数作为 AI 工具执行,以访问私有资源 | |
| AWS Step Functions Tool MCP Server | 执行复杂的工作流和业务流程 | |
| Amazon SNS/SQS MCP Server | 事件驱动的消息传递和队列管理 | |
| Amazon MQ MCP Server | RabbitMQ 和 ActiveMQ 的消息代理管理 |
Operations & Monitoring
| 服务名称 | 描述 | 安装 |
|---|---|---|
| Amazon CloudWatch MCP Server | 指标、告警和日志分析及运维故障排查 | |
| Amazon CloudWatch Application Signals MCP Server | 应用监控和性能洞察 | |
| AWS Managed Prometheus MCP Server | 兼容 Prometheus 的运维和监控 | |
| AWS Security Agent MCP Server | 使用 AWS Security Agent 进行自动化安全扫描、渗透测试和修复 | |
| AWS Well-Architected Security Assessment Tool MCP Server | 根据 Well-Architected Framework 安全支柱评估 AWS 环境 | |
| AWS CloudTrail MCP Server | CloudTrail 事件查询和分析 | |
| AWS Systems Manager for SAP MCP Server | 通过运行状况检查、配置验证和计划安排,管理、监控和运维 AWS 上的 SAP 应用程序 |
MCP AWS Lambda 处理器模块
一个使用 AWS Lambda 为模型上下文协议(MCP)创建无服务器 HTTP 处理器的 Python 库。该模块提供了一个灵活的框架,用于构建 MCP HTTP 端点,支持可插拔的会话管理,并内置 DynamoDB 支持。
功能:
- 使用 AWS Lambda 轻松创建无服务器 MCP HTTP 处理器
- 可插拔的会话管理系统
- 内置 DynamoDB 会话后端支持
- 可自定义身份验证和授权
- 示例实现和测试
完整的使用、安装和开发说明,请参阅 src/mcp-lambda-handler/README.md。
何时使用本地 MCP 服务,何时使用远程 MCP 服务?
MCP 服务既可以在本地开发计算机上运行,也可以在云端远程运行。以下是两种方式各自适用的场景:
本地 MCP 服务
- 开发与测试:非常适合本地开发、测试和调试
- 离线工作:在互联网连接受限时继续工作
- 数据隐私:将敏感数据和凭证保留在本地计算机上
- 低延迟:网络开销极小,响应速度更快
- 资源控制:直接控制服务资源和配置
远程 MCP 服务
- 团队协作:在团队中共享一致的服务配置
- 资源密集型任务:将繁重的处理任务交给专用云资源
- 始终可用:随时随地通过任何设备访问 MCP 服务
- 自动更新:自动获取最新功能和安全补丁
- 可扩展性:轻松应对不同工作负载,不受本地资源限制
- 安全性:通过基于 IAM 的权限和零凭证暴露,实现集中式安全控制
- 治理:全面的审计日志记录和合规监控,满足企业级治理要求
注意:某些 MCP 服务(例如官方 AWS MCP 服务(预览版)和 AWS Knowledge MCP)由 AWS 作为完全托管服务提供。这些由 AWS 管理的远程服务无需你进行任何设置或基础设施管理,只需连接即可开始使用。
服务的使用场景
例如,你可以使用 AWS Documentation MCP Server,帮助 AI 助手研究任何 AWS 服务并生成最新代码,例如 Amazon Bedrock Inline agents。你也可以使用 CDK MCP Server 或 Terraform MCP Server,让 AI 助手创建使用最新 API 并遵循 AWS 最佳实践的基础设施即代码实现。借助 AWS Pricing MCP Server,你可以询问“部署之前,这个 CDK 项目的预计月度费用是多少?”或“你能帮我了解此基础设施设计可能产生的 AWS 服务费用吗?”,并获取详细的成本估算和预算规划建议。Valkey MCP Server 支持通过自然语言与 Valkey 数据存储交互,让 AI 助手通过简单的对话界面高效管理数据操作。
安装和设置
每个服务都有专属安装说明,并提供适用于 Kiro、Cursor 和 VSCode 的一键安装方式。通常,你可以:
- 从 Astral 安装
uv - 使用
uv python install 3.10安装 Python - 配置 AWS 凭证,以访问所需服务
- 将服务添加到 MCP 客户端配置中
Kiro MCP 设置的示例配置(~/.kiro/settings/mcp.json):
适用于 macOS/Linux
{
"mcpServers": {
"awslabs-core-mcp-server": {
"command": "uvx",
"args": [
"awslabs.core-mcp-server@latest"
],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR"
}
}
}
}
有关具体要求和配置选项,请参阅各服务的 README。
Windows
在 Windows 上配置 MCP 服务时,需要使用略有不同的配置格式:
{
"mcpServers": {
"awslabs-core-mcp-server": {
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "uv",
"args": [
"tool",
"run",
"--from",
"awslabs.core-mcp-server@latest",
"awslabs.core-mcp-server.exe"
],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR"
}
}
}
}
如果 MCP 配置有问题,或者想检查是否设置了适当的参数,可以尝试以下操作:
# Run MCP server manually with timeout 15s
$ timeout 15s uv tool run <MCP Name> <args> 2>&1 || echo "Command completed or timed out"
# Example (Aurora MySQL MCP Server)
$ timeout 15s uv tool run awslabs.mysql-mcp-server --resource_arn <Your Resource ARN> --secret_arn <Your Secret ARN> ... 2>&1 || echo "Command completed or timed out"
# If the arguments are not set appropriately, you may see the following message:
usage: awslabs.mysql-mcp-server [-h] --resource_arn RESOURCE_ARN --secret_arn SECRET_ARN --database DATABASE
--region REGION --readonly READONLY
awslabs.mysql-mcp-server: error: the following arguments are required: --resource_arn, --secret_arn, --database, --region, --readonly
关于使用 uvx "@latest" 后缀时的性能说明:
使用 "@latest" 后缀时,每次启动 MCP 客户端都会检查并从 pypi 下载最新的 MCP 服务包,但这会增加初始加载时间。如果想尽量缩短初始加载时间,可以移除 "@latest",并通过以下任一方式自行管理 uv 缓存:
uv cache clean <tool>:其中 {tool} 是要从缓存中删除并重新安装的 MCP 服务(例如:"awslabs.lambda-tool-mcp-server")(记得移除 '<>')。uvx <tool>@latest:此命令会将工具更新到最新版本,并将其添加到 uv 缓存中。
在容器中运行 MCP 服务
每个 MCP 服务的 Docker 镜像都发布在 public AWS ECR registry。
此示例使用 Docker 和 "awslabs.aws-documentation-mcp-server",可用于其他 MCP 服务。
-
可选择将敏感环境变量保存到文件中:
# contents of a .env file with fictitious AWS temporary credentials AWS_ACCESS_KEY_ID=ASIAIOSFODNN7EXAMPLE AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY AWS_SESSION_TOKEN=AQoEXAMPLEH4aoAH0gNCAPy...truncated...zrkuWJOgQs8IZZaIv2BXIa2R4Olgk -
按需使用 Docker 选项:
--env、--env-file和--volume,因为容器内无法使用"env": {}。{ "mcpServers": { "awslabs.aws-documentation-mcp-server": { "command": "docker", "args": [ "run", "--rm", "--interactive", "--env", "FASTMCP_LOG_LEVEL=ERROR", "--env", "AWS_REGION=us-east-1", "--env-file", "/full/path/to/.env", "--volume", "/full/path/to/.aws:/app/.aws", "public.ecr.aws/awslabs-mcp/awslabs/aws-documentation-mcp-server:latest" ], "env": {} } } } -
若要测试本地更改,可以构建并标记镜像。必须更新 MCP 配置,使用此标记代替 ECR 镜像。
cd src/aws-documentation-mcp-server docker build -t awslabs/aws-documentation-mcp-server .
开始使用 Kiro
在 Kiro 中安装
详情请参阅 Kiro IDE documentation 或 Kiro CLI documentation。
在 Kiro IDE 中:
- 前往
Kiro>MCP Servers - 点击
+ Add按钮添加新的 MCP 服务。 - 粘贴下方提供的配置。
对于全局配置,请编辑 ~/.kiro/settings/mcp.json。对于项目专属配置,请编辑项目目录中的 .kiro/settings/mcp.json。
~/.kiro/settings/mcp.json
macOS/Linux:
{
"mcpServers": {
"awslabs-core-mcp-server": {
"command": "uvx",
"args": ["awslabs.core-mcp-server@latest"],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR"
}
}
}
}
Windows:
{
"mcpServers": {
"awslabs-core-mcp-server": {
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "uv",
"args": [
"tool",
"run",
"--from",
"awslabs.core-mcp-server@latest",
"awslabs.core-mcp-server.exe"
],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR"
}
}
}
}
Cline 和 Amazon Bedrock 入门
重要: 按照这些说明操作可能会产生费用,相关费用以 Amazon Bedrock 定价为准。你需要承担所有相关费用。除了在 Cline 设置中选择所需的模型外,还要确保已在 Amazon Bedrock 中启用所选模型(例如,anthropic.claude-3-7-sonnet)。有关如何启用 Amazon Bedrock 基础模型(FMs)访问权限的更多信息,请参阅这些 AWS 文档。
-
按照上方 安装与设置 部分中的步骤,从 Astral 安装
uv、安装 Python,并配置具有所需服务权限的 AWS 凭证。 -
如果使用 Visual Studio Code,请安装 Cline VS Code 扩展(或适用于你所选 IDE 的同类扩展)。安装后,点击该扩展将其打开。出现提示时,选择所需的套餐。本例中我们将使用 Amazon Bedrock,因此 Cline 的免费套餐即可满足需求,因为我们会通过 Amazon Bedrock API 而非 Cline API 发送请求。
- 选择 MCP 服务 按钮。
- 选择 已安装 选项卡,然后点击 配置 MCP 服务,打开
cline_mcp_settings.json文件。
- 在
cline_mcp_settings.json文件中,将所需的 MCP 服务添加到mcpServers对象中。以下示例将使用本仓库中当前提供的一些 MCP 服务。请确保保存文件,以安装这些 MCP 服务。
cline_mcp_settings.json
对于 macOS/Linux:
{
"mcpServers": {
"awslabs-core-mcp-server": {
"command": "uvx",
"args": ["awslabs.core-mcp-server@latest"],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR",
"MCP_SETTINGS_PATH": "path to your mcp settings file"
}
}
}
}
对于 Windows:
{
"mcpServers": {
"awslabs-core-mcp-server": {
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "uv",
"args": [
"tool",
"run",
"--from",
"awslabs.core-mcp-server@latest",
"awslabs.core-mcp-server.exe"
],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR",
"MCP_SETTINGS_PATH": "path to your mcp settings file"
}
}
}
}
- 安装完成后,你应该会在 MCP Server Installed 选项卡下看到 MCP 服务列表,并且它们旁边会显示绿色滑块,表示已启用。以下示例展示了两个可用于 AWS 的 MCP 服务。完成后,点击 Done。此时你应该会看到 Cline 聊天界面。
-
默认情况下,Cline 会设为 API 提供商,但免费套餐有使用限制。接下来,我们将把 API 提供商更改为 AWS Bedrock,这样就可以通过 Bedrock 使用大模型,并由你已连接的 AWS 账户结算费用。
-
点击设置齿轮,打开 Cline 设置。在 API Provider 下,将
Cline切换为AWS Bedrock,并将AWS Profile选为身份验证类型。请注意,AWS Credentials选项也可以使用,但它会使用静态凭证(Access Key ID 和 Secret Access Key),而不是令令牌过期时自动轮换的临时凭证。因此,使用 AWS Profile 的临时凭证更安全,也是推荐的方式。
- 根据你想使用的现有 AWS Profile 填写配置,选择所需的 AWS Region,并启用跨区域推理。
- 接下来,在设置页面向下滚动,直到找到标有 Custom Instructions 的文本框。粘贴以下代码片段,确保每次提示词都从
mcp-core服务开始使用:
For every new project, always look at your MCP servers and use mcp-core as the starting point every time. Also after a task completion include the list of MCP servers used in the operation.
-
粘贴自定义提示词后,点击 Done 返回聊天界面。
-
现在,你可以开始提问并测试已安装 MCP 服务的功能。聊天界面的默认选项是
Plan,它会提供供你手动执行的输出(例如,提供一份配置示例供你复制并粘贴到文件中)。不过,你也可以选择切换到Act,让 Cline 代你执行操作(例如使用网页浏览器搜索内容、克隆仓库、执行代码等)。你还可以选择开启“Auto-approve”选项,免去点击批准建议的步骤;不过,我们建议在测试期间保持此选项关闭,尤其是在选择了 Act 开关的情况下。
注意: 为获得最佳效果,请提示 Cline 使用你想用的 MCP 服务。例如,Using the Terraform MCP Server, do...
开始使用 Cursor
-
按照上方 安装和设置 部分中的步骤,从 Astral 安装
uv,安装 Python,并配置所需服务的 AWS 凭证。 -
根据使用场景,可以在两个位置放置 MCP 配置:
A. 项目配置
- 对于特定项目的工具,请在项目目录中创建 .cursor/mcp.json 文件。
- 这样可以定义仅在该特定项目中可用的 MCP 服务。
B. 全局配置
- 对于希望在所有项目中使用的工具,请在主目录中创建 ~/.cursor/mcp.json 文件。
- 这样,所有 Cursor 工作区都可以使用这些 MCP 服务。
.cursor/mcp.json
适用于 macOS/Linux:
{
"mcpServers": {
"awslabs-core-mcp-server": {
"command": "uvx",
"args": ["awslabs.core-mcp-server@latest"],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR"
}
}
}
}
适用于 Windows:
{
"mcpServers": {
"awslabs-core-mcp-server": {
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "uv",
"args": [
"tool",
"run",
"--from",
"awslabs.core-mcp-server@latest",
"awslabs.core-mcp-server.exe"
],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR"
}
}
}
}
-
在聊天中使用 MCP Composer Agent 会自动使用 MCP 设置页面的“可用工具”下列出的 MCP 工具(前提是它判断这些工具与当前任务相关)。如需主动调用工具,请提示 Cursor 使用你希望调用的 MCP 服务。例如:
使用 Terraform MCP Server,执行…… -
工具审批 默认情况下,当 Agent 想要使用 MCP 工具时,会显示一条消息请求你的批准。你可以点击工具名称旁边的箭头展开消息,查看 Agent 调用该工具时使用的参数。
开始使用 Windsurf
开始使用 Windsurf
-
按照上方 安装和设置 部分中的步骤,从 Astral 安装
uv,安装 Python,并配置所需服务的 AWS 凭证。 -
访问 MCP 设置
- 前往 Windsurf - Settings > Advanced Settings,或使用 Command Palette > Open Windsurf Settings Page
- 找到“Model Context Protocol (MCP) Servers”部分
-
添加 MCP 服务
- 点击“Add Server”以添加新的 MCP 服务
- 你可以从可用模板中选择,例如 GitHub、Puppeteer、PostgreSQL 等。
- 也可以点击“Add custom server”来配置自己的服务
-
手动配置
- 你也可以手动编辑位于
~/.codeium/windsurf/mcp_config.json的 MCP 配置文件
- 你也可以手动编辑位于
~/.codeium/windsurf/mcp_config.json
适用于 macOS/Linux:
{
"mcpServers": {
"awslabs-core-mcp-server": {
"command": "uvx",
"args": ["awslabs.core-mcp-server@latest"],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR",
"MCP_SETTINGS_PATH": "path to your mcp settings file"
}
}
}
}
适用于 Windows:
{
"mcpServers": {
"awslabs-core-mcp-server": {
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "uv",
"args": [
"tool",
"run",
"--from",
"awslabs.core-mcp-server@latest",
"awslabs.core-mcp-server.exe"
],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR",
"MCP_SETTINGS_PATH": "path to your mcp settings file"
}
}
}
}
开始使用 VS Code
在 VS Code 中安装
在 VS Code 设置中或 .vscode/mcp.json 文件中配置 MCP 服务(更多信息请参阅 VS Code MCP 文档):
.vscode/mcp.json
适用于 macOS/Linux:
{
"mcpServers": {
"awslabs-core-mcp-server": {
"command": "uvx",
"args": ["awslabs.core-mcp-server@latest"],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR"
}
}
}
}
适用于 Windows:
{
"mcpServers": {
"awslabs-core-mcp-server": {
"disabled": false,
"timeout": 60,
"type": "stdio",
"command": "uv",
"args": [
"tool",
"run",
"--from",
"awslabs.core-mcp-server@latest",
"awslabs.core-mcp-server.exe"
],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR"
}
}
}
}
开始使用 Claude Code
在 Claude Code 中安装
通过 CLI 或 .mcp.json 在 Claude Code 中配置 MCP 服务
-
按照上方 安装和设置 部分中的步骤,从 Astral 安装
uv,安装 Python,并配置所需服务的 AWS 凭证。 -
使用 Claude Code CLI 命令
用于添加 MCP 服务的 Claude Code CLI 命令:
# Add core AWS services claude mcp add aws-api uvx awslabs.aws-api-mcp-server@latest claude mcp add aws-iac uvx awslabs.aws-iac-mcp-server@latest claude mcp add aws-docs uvx awslabs.aws-documentation-mcp-server@latest claude mcp add aws-support uvx awslabs.aws-support-mcp-server@latest claude mcp add aws-pricing uvx awslabs.aws-pricing-mcp-server@latest # Add AI/ML and Bedrock services claude mcp add bedrock-kb uvx awslabs.bedrock-kb-retrieval-mcp-server@latest # Add data and analytics services claude mcp add aws-dataprocessing uvx awslabs.aws-dataprocessing-mcp-server@latest claude mcp add aurora-dsql uvx awslabs.aurora-dsql-mcp-server@latest claude mcp add valkey uvx awslabs.valkey-mcp-server@latest # List installed servers claude mcp list -
手动配置(替代方法)
你也可以在项目根目录中创建
.mcp.json文件,手动配置 MCP 服务:
.mcp.json
适用于 macOS/Linux:
{
"mcpServers": {
"awslabs.aws-iac-mcp-server": {
"command": "uvx",
"args": ["awslabs.aws-iac-mcp-server@latest"],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR"
}
},
"awslabs.aws-documentation-mcp-server": {
"command": "uvx",
"args": ["awslabs.aws-documentation-mcp-server@latest"],
"env": {
"FASTMCP_LOG_LEVEL": "ERROR",
"AWS_DOCUMENTATION_PARTITION": "aws"
}
}
}
}
在 fx 中安装
fx 可从终端管理 MCP 服务,并将配置存储在 ~/.fx/mcp.json 中,以便在每个项目中使用。
-
按照上文 安装与设置 部分中的步骤,从 Astral 安装
uv、安装 Python,并使用所需服务配置 AWS 凭证。 -
使用 fx CLI 命令
# The hosted AWS Knowledge MCP Server needs no credentials fx mcp add --transport http aws-knowledge https://knowledge-mcp.global.api.aws # Local servers take the executable and its arguments fx mcp add aws-api uvx awslabs.aws-api-mcp-server@latest fx mcp add aws-iac uvx awslabs.aws-iac-mcp-server@latest fx mcp add aws-iam uvx awslabs.iam-mcp-server@latest # List configured servers fx mcp list -
手动配置(替代方式)
在
mcp键下添加服务。fx 使用mcp而非mcpServers,使用type选择传输方式,并使用一个command数组存放可执行文件及其参数。
~/.fx/mcp.json
{
"mcp": {
"aws-knowledge-mcp-server": {
"type": "http",
"url": "https://knowledge-mcp.global.api.aws"
},
"awslabs.aws-iac-mcp-server": {
"type": "local",
"command": ["uvx", "awslabs.aws-iac-mcp-server@latest"],
"environment": {
"FASTMCP_LOG_LEVEL": "ERROR"
}
}
}
}
首次启动 uvx 服务时会下载软件包,耗时可能超过默认启动超时时间。如有需要,可为该服务延长超时时间:
"startup_timeout_ms": 30000
如果编辑文件时会话已打开,请运行 /mcp reload 以应用更改。
示例
samples 目录中提供了可直接使用的开源 AWS MCP 服务示例。这些示例包含可运行的代码和分步指南,帮助你开始使用每个 MCP 服务。
Vibe 编码
你可以将这些 MCP 服务与 AI 编码助手搭配使用,进行 vibe 编码。如需了解如何提升 vibe 编码体验的技巧,请参阅我们的指南。
其他资源
- 介绍面向代码助手的 AWS MCP 服务
- 使用 AWS MCP 服务进行氛围编程 | AWS Show & Tell
- 借助 AWS MCP 服务加速 AWS 数据库开发
- 使用 Amazon Q CLI 和 AWS Pricing MCP Server 估算 AWS 成本
- 介绍 AWS Serverless MCP Server:面向现代应用的 AI 驱动开发
- 宣布推出面向 AWS Serverless 和 Containers 的全新 Model Context Protocol(MCP)服务
- 借助 Amazon EKS MCP 服务加速应用开发
- Amazon Neptune 宣布推出 MCP(Model Context Protocol)服务
- Terraform MCP Server 氛围编程
- 如何使用 Amazon Q CLI 和 MCP 生成 AWS 架构图
- 借助 Amazon Bedrock Agents 发挥 MCP 服务的强大功能
- 释放 Model Context Protocol(MCP)在 AWS 上的强大功能
- AWS Price List 实现自然语言升级:推出 AWS Pricing MCP Server
- AWS SheBuilds:AWS 团队从内部工具走向开源 AI 基础设施的历程
- AWS MCP 服务氛围编程指南
- 使用 AWS MCP 服务进行氛围编程 | 实践研讨会
安全
如需了解更多信息,请参阅 CONTRIBUTING。
贡献
衷心感谢各位出色的贡献者!感谢你们让这个项目变得更好!
欢迎各种形式的贡献!如需了解更多信息,请查看我们的贡献者指南。
开发者指南
如果你想向库中添加新的 MCP Server,请查看我们的开发指南,并务必遵循我们的设计指南。
许可证
本项目采用 Apache-2.0 许可证授权。
免责声明
在使用 MCP Server 之前,你应考虑进行独立评估,以确保你的使用符合自身特定的安全和质量控制实践与标准,以及适用于你和你的内容的法律、规则和法规。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。