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 服務的清單(僅限中國)

先決條件

安裝需求

  1. AstralGitHub README 安裝 uv
  2. 使用 uv python install 3.10(或更新版本)安裝 Python 3.10 或更新版本

安裝

KiroCursorVS Code
Add to KiroInstall MCP ServerInstall on 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_PARTITIONAWS 分割區 (awsaws-cn)aws
MCP_USER_AGENTHTTP 請求的自訂 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"
  }
}

基本用法

範例:

AWS Documentation MCP Demo

工具

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