AWS Documentation

AWS Dokümantasyon MCP Sunucusu

AWS Dokümantasyonu için Model Bağlam Protokolü (MCP) sunucusu

Bu MCP sunucusu, AWS dokümantasyonuna erişmek, içerik aramak ve öneriler almak için araçlar sağlar.

Özellikler

• Dokümantasyonu Oku: AWS dokümantasyon sayfalarını alır ve markdown formatına dönüştürür
• Dokümantasyonda Ara: Resmi arama API'sini kullanarak AWS dokümantasyonunda arama yapar (yalnızca global)
• Bölümleri Oku: AWS dokümantasyon sayfasının bölümlerini alır ve markdown formatına dönüştürür.
• Tabloda Ara: Büyük dokümantasyon tablolarındaki (örn. servis kotaları, fiyatlandırma) satırları, sayfanın tamamını okumadan filtreler ve arar (yalnızca global)
• Öneriler: AWS dokümantasyon sayfaları için içerik önerileri alır (yalnızca global)
• Kullanılabilir Servis Listesini Al: Çin bölgelerindeki kullanılabilir AWS servislerinin listesini alır (yalnızca Çin)

Ön Koşullar

Kurulum Gereksinimleri

1. uv'i Astral veya GitHub README üzerinden kurun
2. uv python install 3.10 kullanarak Python 3.10 veya daha yenisini (ya da daha güncel bir sürüm) kurun

Kurulum

Kiro	Cursor	VS Code

MCP sunucusunu MCP istemci yapılandırmanızda yapılandırın:

{
  "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 yapılandırması için ayrıntılı bilgi için Kiro IDE dokümantasyonuna veya Kiro CLI dokümantasyonuna bakın.

Global yapılandırma için ~/.kiro/settings/mcp.json dosyasını düzenleyin. Projeye özel yapılandırma için proje dizininizdeki .kiro/settings/mcp.json dosyasını düzenleyin.

Windows Kurulumu

Windows kullanıcıları için MCP sunucu yapılandırma formatı biraz farklıdır:

{
  "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"
      }
    }
  }
}

Not: Global AWS dokümantasyonu yerine AWS Çin dokümantasyonunu sorgulamak için AWS_DOCUMENTATION_PARTITION değerini aws-cn olarak ayarlayın.

Kurumsal Ağlar: Belirli User-Agent dizelerini engelleyen bir kurumsal proxy veya güvenlik duvarının arkasındaysanız, MCP_USER_AGENT değerini tarayıcınızın User-Agent dizesiyle eşleşecek şekilde izin verilen bir dizeye ayarlayın.

veya başarılı bir docker build -t mcp/aws-documentation . işleminden sonra 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": []
    }
  }
}

Ortam Değişkenleri

Değişken	Açıklama	Varsayılan
FASTMCP_LOG_LEVEL	Günlük seviyesi (DEBUG, INFO, WARNING, ERROR, CRITICAL)	WARNING
AWS_DOCUMENTATION_PARTITION	AWS bölümü (aws veya aws-cn)	aws
MCP_USER_AGENT	HTTP istekleri için özel User-Agent dizesi	Chrome tabanlı varsayılan

Kurumsal Ağ Desteği

Belirli User-Agent dizelerini engelleyen proxy sunucuları veya güvenlik duvarları olan kurumsal ortamlar için:

{
  "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"
  }
}

Temel Kullanım

Örnek:

• "S3 bucket adlandırma kuralı hakkında dokümantasyona bak. kaynaklarını belirt"
• "https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html sayfası için içerik öner"

Araçlar

read_documentation

Bir AWS dokümantasyon sayfasını alır ve markdown formatına dönüştürür.

read_documentation(url: str) -> str

search_documentation (yalnızca global)

Resmi AWS Dokümantasyon Arama API'sini kullanarak AWS dokümantasyonunda arama yapar.

search_documentation(ctx: Context, search_phrase: str, limit: int, product_types: Optional[List[str]], guide_types: Optional[List[str]]) -> SearchResponse

read_sections (yalnızca global)

AWS dokümantasyon sayfasının bölümlerini alır ve markdown formatına dönüştürür.

read_sections(url: str, section: list[str]) -> list[dict]

search_table (yalnızca global)

Büyük dokümantasyon tablolarındaki (örn. servis kotaları, fiyatlandırma tabloları, desteklenen modeller) belirli satırları arar. Yüzlerce tablo satırı içeren sayfalar için read_sections kullanmaktan daha verimlidir — tam tablo yerine eşleşen satırları yapılandırılmış JSON olarak döndürür.

search_table(url: str, section_title: Optional[str], query: str, max_rows: int = 20) -> SearchTableResponse

recommend (yalnızca global)

Bir AWS dokümantasyon sayfası için içerik önerileri alır.

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

get_available_services (yalnızca Çin)

Çin bölgelerindeki kullanılabilir AWS servislerinin listesini alır.

get_available_services() -> str

Geliştirme

AWS Dokümantasyon MCP sunucusunda geliştirmeye başlamak için lütfen önce awslabs/mcp DEVELOPER_GUIDE belgesine bakın. Aşağıdaki her şey AWS Dokümantasyon MCP Sunucusu geliştirmesine özeldir.

Testleri Çalıştırma

Birim testleri: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing Entegrasyon testleriyle birim testleri: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing --run-live