AWS Documentation

AWS Documentation MCP Server

Model Context Protocol (MCP) เซิร์ฟเวอร์สำหรับ AWS Documentation

เซิร์ฟเวอร์ MCP นี้มีเครื่องมือสำหรับเข้าถึงเอกสาร AWS, ค้นหาเนื้อหา และรับคำแนะนำ

คุณสมบัติ

• อ่านเอกสาร: ดึงและแปลงหน้าเอกสาร AWS เป็นรูปแบบ markdown
• ค้นหาเอกสาร: ค้นหาเอกสาร AWS โดยใช้ API การค้นหาอย่างเป็นทางการ (ทั่วโลกเท่านั้น)
• อ่านส่วนต่างๆ: ดึงส่วนต่างๆ ของหน้าเอกสาร AWS และแปลงเป็นรูปแบบ markdown
• ค้นหาตาราง: กรองและค้นหาแถวในตารางเอกสารขนาดใหญ่ (เช่น โควต้าบริการ, ราคา) โดยไม่ต้องอ่านทั้งหน้า (ทั่วโลกเท่านั้น)
• คำแนะนำ: รับคำแนะนำเนื้อหาสำหรับหน้าเอกสาร AWS (ทั่วโลกเท่านั้น)
• รับรายการบริการที่พร้อมใช้งาน: รับรายการบริการ AWS ที่พร้อมใช้งานในภูมิภาคจีน (จีนเท่านั้น)

ข้อกำหนดเบื้องต้น

ข้อกำหนดในการติดตั้ง

1. ติดตั้ง uv จาก Astral หรือ GitHub README
2. ติดตั้ง Python 3.10 หรือใหม่กว่าโดยใช้ uv python install 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 China แทนเอกสาร AWS ทั่วโลก

เครือข่ายองค์กร: หากคุณอยู่หลังพร็อกซีหรือไฟร์วอลล์ขององค์กรที่บล็อกสตริง User-Agent บางอย่าง ให้ตั้งค่า MCP_USER_AGENT ให้ตรงกับ User-Agent ของเบราว์เซอร์ของคุณเป็นสตริงที่อนุญาต

หรือ docker หลังจาก docker build -t mcp/aws-documentation . สำเร็จ:

{
  "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	สตริง User-Agent ที่กำหนดเองสำหรับคำขอ HTTP	ค่าเริ่มต้นแบบ 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 Documentation MCP server โปรดดู awslabs/mcp DEVELOPER_GUIDE ก่อน ทุกอย่างด้านล่างนี้เฉพาะเจาะจงกับการพัฒนา AWS Documentation MCP Server

การรันการทดสอบ

การทดสอบหน่วย: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing การทดสอบหน่วยพร้อมการทดสอบการรวมระบบ: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing --run-live