AWS Documentation

Servidor MCP de Documentação da AWS

Servidor do Protocolo de Contexto de Modelo (MCP) para Documentação da AWS

Este servidor MCP fornece ferramentas para acessar a documentação da AWS, pesquisar conteúdo e obter recomendações.

Funcionalidades

• Ler Documentação: Busca e converte páginas da documentação da AWS para o formato markdown
• Pesquisar Documentação: Pesquisa na documentação da AWS usando a API de pesquisa oficial (somente global)
• Ler Seções: Busca seções de uma página da documentação da AWS e as converte para o formato markdown.
• Pesquisar Tabela: Filtra e pesquisa linhas em grandes tabelas de documentação (ex.: cotas de serviço, preços) sem ler a página inteira (somente global)
• Recomendações: Obtém recomendações de conteúdo para páginas da documentação da AWS (somente global)
• Obter Lista de Serviços Disponíveis: Obtém uma lista dos serviços da AWS disponíveis nas regiões da China (somente China)

Pré-requisitos

Requisitos de Instalação

1. Instale o uv a partir do Astral ou do README do GitHub
2. Instale o Python 3.10 ou mais recente usando o uv python install 3.10 (ou uma versão mais recente)

Instalação

Kiro	Cursor	VS Code

Configure o servidor MCP na configuração do seu cliente 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": []
    }
  }
}

Para a configuração do MCP no Kiro, consulte a documentação do Kiro IDE ou a documentação da Kiro CLI para obter detalhes.

Para configuração global, edite ~/.kiro/settings/mcp.json. Para configuração específica do projeto, edite .kiro/settings/mcp.json no diretório do seu projeto.

Instalação no Windows

Para usuários do Windows, o formato de configuração do servidor MCP é ligeiramente diferente:

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

Nota: Defina AWS_DOCUMENTATION_PARTITION como aws-cn para consultar a documentação da AWS China em vez da documentação global da AWS.

Redes Corporativas: Se você estiver atrás de um proxy corporativo ou firewall que bloqueie certas strings de User-Agent, defina MCP_USER_AGENT para corresponder ao User-Agent do seu navegador com uma string permitida.

ou docker após um docker build -t mcp/aws-documentation . bem-sucedido:

{
  "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": []
    }
  }
}

Variáveis de Ambiente

Variável	Descrição	Padrão
FASTMCP_LOG_LEVEL	Nível de log (DEBUG, INFO, WARNING, ERROR, CRITICAL)	WARNING
AWS_DOCUMENTATION_PARTITION	Partição da AWS (aws ou aws-cn)	aws
MCP_USER_AGENT	String de User-Agent personalizada para requisições HTTP	Padrão baseado no Chrome

Suporte a Redes Corporativas

Para ambientes corporativos com servidores proxy ou firewalls que bloqueiam certas strings de 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"
  }
}

Uso Básico

Exemplo:

• "procure documentação sobre regras de nomenclatura de buckets S3. cite suas fontes"
• "recomende conteúdo para a página https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html"

Ferramentas

read_documentation

Busca uma página da documentação da AWS e a converte para o formato markdown.

read_documentation(url: str) -> str

search_documentation (somente global)

Pesquisa na documentação da AWS usando a API oficial de Pesquisa da Documentação da AWS.

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

read_sections (somente global)

Busca seções de uma página da documentação da AWS e as converte para o formato markdown.

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

search_table (somente global)

Pesquisa linhas específicas em grandes tabelas de documentação (ex.: cotas de serviço, tabelas de preços, modelos suportados). Mais eficiente que read_sections para páginas com centenas de linhas de tabela — retorna as linhas correspondentes como JSON estruturado em vez da tabela completa.

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

recommend (somente global)

Obtém recomendações de conteúdo para uma página da documentação da AWS.

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

get_available_services (somente China)

Obtém uma lista dos serviços da AWS disponíveis nas regiões da China.

get_available_services() -> str

Desenvolvimento

Para começar com o desenvolvimento no servidor MCP de Documentação da AWS, consulte primeiro o GUIA_DO_DESENVOLVEDOR do awslabs/mcp. Tudo abaixo disto é específico para o desenvolvimento do Servidor MCP de Documentação da AWS.

Executando testes

Testes unitários: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing Testes unitários com testes de integração: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing --run-live