AWS代码示例MCP服务器

提供访问AWS代码示例、搜索内容和获取推荐的工具,适用于开发者在AWS文档和代码示例中快速查找和使用相关资源。

  • by hugh-weston
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 hugh-weston/aws-code-examples-mcp

使用说明

AWS文档代码示例MCP服务器

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

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

特性

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

先决条件

安装要求

  1. 安装 uv 从 星体 或 GitHub自述
  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