AWS Documentation
官方获取、转换和搜索AWS文档页面,并提供相关内容推荐。
你可以用 AWS Documentation MCP 做什么?
- 阅读任意 AWS 文档页面 — 通过
read_documentation获取文档页面并转换为 Markdown 格式。 - 跨 AWS 文档搜索 — 使用
search_documentation按关键词、产品类型或指南类型查找相关页面。 - 提取特定章节 — 通过
read_sections仅提取页面中所需的章节内容。 - 查询大型表格 — 借助
search_table搜索服务配额或定价表格中的行数据,无需阅读整个页面。 - 获取相关内容 — 使用
recommend发现给定文档 URL 的推荐页面。
文档
AWS 文档 MCP 服务器
适用于 AWS 文档的模型上下文协议 (MCP) 服务器
此 MCP 服务器提供访问 AWS 文档、搜索内容以及获取推荐的工具。
功能
- 阅读文档:获取 AWS 文档页面并将其转换为 Markdown 格式
- 搜索文档:使用官方搜索 API 搜索 AWS 文档(仅限全球)
- 阅读章节:获取 AWS 文档页面的章节并将其转换为 Markdown 格式。
- 搜索表格:无需阅读整个页面,即可筛选和搜索大型文档表格中的行(例如服务配额、定价)(仅限全球)
- 推荐:获取 AWS 文档页面的内容推荐(仅限全球)
- 获取可用服务列表:获取中国区域可用的 AWS 服务列表(仅限中国)
先决条件
安装要求
- 从 Astral 或 GitHub README 安装
uv - 使用
uv python install 3.10(或更新版本)安装 Python 3.10 或更高版本
安装
| Kiro | 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": []
}
}
}
有关 Kiro MCP 配置,请参阅 Kiro IDE 文档 或 Kiro CLI 文档 了解详情。
对于全局配置,请编辑 ~/.kiro/settings/mcp.json。对于项目特定配置,请在您的项目目录中编辑 .kiro/settings/mcp.json。
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(ctx: Context, search_phrase: str, limit: int, product_types: Optional[List[str]], guide_types: Optional[List[str]]) -> SearchResponse
read_sections(仅限全球)
获取 AWS 文档页面的章节并将其转换为 Markdown 格式。
read_sections(url: str, section: list[str]) -> list[dict]
search_table(仅限全球)
在大型文档表格(例如服务配额、定价表、支持的模型)中搜索特定行。对于包含数百个表格行的页面,比 read_sections 更高效——将匹配的行作为结构化 JSON 返回,而非整个表格。
search_table(url: str, section_title: Optional[str], query: str, max_rows: int = 20) -> SearchTableResponse
recommend(仅限全球)
获取 AWS 文档页面的内容推荐。
recommend(url: str) -> list[dict]
get_available_services(仅限中国)
获取中国区域可用的 AWS 服务列表。
get_available_services() -> str
开发
有关开始开发 AWS 文档 MCP 服务器的信息,请首先参阅 awslabs/mcp DEVELOPER_GUIDE。以下所有内容均特定于 AWS 文档 MCP 服务器开发。
运行测试
单元测试:uv run --frozen pytest --cov --cov-branch --cov-report=term-missing
包含集成测试的单元测试:uv run --frozen pytest --cov --cov-branch --cov-report=term-missing --run-live