AWS Documentation MCP Server

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ümantasyon Okuma: AWS dokümantasyon sayfalarını getirir ve markdown formatına dönüştürür
• Dokümantasyon Arama: Resmi arama API'sini kullanarak AWS dokümantasyonunda arama yapar (yalnızca global)
• Bölümleri Okuma: AWS dokümantasyon sayfasının bölümlerini getirir ve markdown formatına dönüştürür.
• Öneriler: AWS dokümantasyon sayfaları için içerik önerileri alır (yalnızca global)
• Kullanılabilir Hizmet Listesini Al: Çin bölgelerindeki kullanılabilir AWS hizmetlerinin 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 kurun (ya da daha güncel bir sürüm)

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 sunucusu 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ı getirir 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 getirir ve markdown formatına dönüştürür.

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

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 hizmetlerinin listesini alır.

get_available_services() -> str

Geliştirme

AWS Dokümantasyon MCP sunucusu üzerinde geliştirmeye başlamak için lütfen önce awslabs/mcp GELİŞTİRİCİ_KILAVUZU'na başvurun. 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 testleri ile birim testleri: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing --run-live