AWS 文档 MCP 服务器

Model Context Protocol (MCP) 服务器用于 AWS 文档。

此 MCP 服务器提供了访问 AWS 文档、搜索内容和获取推荐的功能。

功能

• 阅读文档：抓取并转换 AWS 文档页面为 Markdown 格式
• 搜索文档：使用官方搜索 API 搜索 AWS 文档（仅限全球）
• 推荐内容：获取 AWS 文档页面的内容推荐（仅限全球）
• 获取可用服务列表：获取中国区域中可用的 AWS 服务列表（仅限中国）

预备条件

安装要求

1. 从 Astral 或 GitHub README 安装 uv
2. 使用 uv python install 3.10 安装 Python 3.10 或更高版本（或更新版本）

安装

Cursor	VS Code

在您的 MCP 客户端配置中设置 MCP 服务器：

{
  "mcpServers": {
    "awslabs.aws-documentation-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.aws-documentation-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_DOCUMENTATION_PARTITION": "aws",
        "MCP_USER_AGENT": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

对于 Amazon Q 开发者 CLI，将 MCP 客户端配置和工具命令添加到 ~/.aws/amazonq/cli-agents 文件中。

例如，~/.aws/amazonq/cli-agents/default.json：

{
  "mcpServers": {
    "awslabs.aws-documentation-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.aws-documentation-mcp-server@latest"],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_DOCUMENTATION_PARTITION": "aws"
      },
      "disabled": false,
      "autoApprove": []
    }
  },
  "tools": [
    // .. 其他现有工具
    "@awslabs.aws-documentation-mcp-server"
  ],
}

Windows 安装

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

{
  "mcpServers": {
    "awslabs.aws-documentation-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.aws-documentation-mcp-server@latest",
        "awslabs.aws-documentation-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_DOCUMENTATION_PARTITION": "aws"
      }
    }
  }
}

注意：将 AWS_DOCUMENTATION_PARTITION 设置为 aws-cn 以查询 AWS 中国的文档而不是全球 AWS 文档。

企业网络：如果您处于公司代理或防火墙后，这些代理或防火墙会阻止某些 User-Agent 字符串，请将 MCP_USER_AGENT 设置为您浏览器的 User-Agent 字符串。

或者在成功执行 docker build -t mcp/aws-documentation . 后使用 Docker：

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

环境变量

变量	描述	默认值
FASTMCP_LOG_LEVEL	日志级别（DEBUG, INFO, WARNING, ERROR, CRITICAL）	WARNING
AWS_DOCUMENTATION_PARTITION	AWS 分区（aws 或 aws-cn）	aws
MCP_USER_AGENT	自定义 HTTP 请求的 User-Agent 字符串	基于 Chrome 的默认值

企业网络支持

对于具有代理服务器或防火墙的企业环境，这些代理服务器或防火墙会阻止某些 User-Agent 字符串：

{
  "env": {
    "MCP_USER_AGENT": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36"
  }
}

基本用法

示例：

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

工具

read_documentation

抓取 AWS 文档页面并将其转换为 Markdown 格式。

read_documentation(url: str) -> str

search_documentation （仅限全球）

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

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

recommend （仅限全球）

获取 AWS 文档页面的内容推荐。

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

get_available_services （仅限中国）

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

get_available_services() -> str