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. 從 Astral 或 GitHub 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 分割區 (aws 或 aws-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