Aws Code Examples MCP

AWS文档代码示例MCP服务器

AWS文档代码示例的模型上下文协议（MCP）服务器

此MCP服务器提供访问AWS代码示例、搜索内容和获取建议的工具。

特性

• 阅读文档：获取AWS文档页面并将其转换为markdown格式
• 搜索文档：使用官方搜索API搜索AWS文档（仅限全球）
• 建议：获取AWS文档页面的内容建议（仅限全球）
• 搜索代码示例：搜索所有服务和编程语言的AWS代码示例
• 阅读代码示例：检索特定示例的完整源代码和上下文
• 设置代码示例：下载并准备本地开发和测试的代码示例
• 获取可用服务列表：获取中国地区可用的AWS服务列表（仅限中国）

先决条件

安装要求

1. 安装 uv 从 星体 或
2. 使用以下命令安装Python 3.10或更高版本 uv python install 3.10 （或更新版本）

安装

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

{
  "mcpServers": {
    "aws-code-examples-mcp": {
      "command": "uvx",
      "args": ["/path/to/aws-code-examples-mcp"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_DOCUMENTATION_PARTITION": "aws",
        "AWS_REGION": "us-east-1",
        "CODE_EXAMPLES_S3_VECTOR_BUCKET": "code-examples-mcp-demo",
        "CODE_EXAMPLES_S3_VECTOR_INDEX": "text-index",
        "BEDROCK_TEXT_EMBEDDING_MODEL_ID": "amazon.titan-embed-text-v2:0",
        "SAGEMAKER_CODE_EMBEDDING_MODEL_ID": "nomic-embed-code-endpoint",
        "CODE_CONTENT_S3_BUCKET": "code-example-content-partitions"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

备注：设置 AWS_DOCUMENTATION_PARTITION 到 aws-cn 查询AWS中国文档，而不是全球AWS文档。

基本用法

例子：

• “查找有关S3存储桶命名规则的文档。引用您的来源”
• “为页面推荐内容https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html"

工具

read_文档

获取AWS文档页面并将其转换为markdown格式。

read_documentation(url: str) -> str

search_文档（仅限全局）

使用官方AWS文档搜索API搜索AWS文档。

search_documentation(search_phrase: str, limit: int) -> list[dict]

推荐（仅限全球）

获取AWS文档页面的内容建议。

recommend(url: str) -> list[dict]

获取可用服务（仅限中国）

获取中国地区可用AWS服务的列表。

get_available_services() -> str

发展

安装依赖项：

uv sync --dev

运行测试：

uv run pytest

运行服务器：

uv run aws-code-examples-mcp

许可证

阿帕奇-2.0