AWS Documentation

Serveur MCP Documentation AWS

Serveur Model Context Protocol (MCP) pour la Documentation AWS

Ce serveur MCP fournit des outils pour accéder à la documentation AWS, rechercher du contenu et obtenir des recommandations.

Fonctionnalités

• Lire la documentation : Récupère et convertit les pages de documentation AWS au format markdown
• Rechercher dans la documentation : Recherche dans la documentation AWS à l'aide de l'API de recherche officielle (mondial uniquement)
• Lire des sections : Récupère des sections d'une page de documentation AWS et les convertit au format markdown.
• Rechercher dans un tableau : Filtre et recherche des lignes dans de grands tableaux de documentation (par exemple, quotas de service, tarification) sans lire la page entière (mondial uniquement)
• Recommandations : Obtient des recommandations de contenu pour les pages de documentation AWS (mondial uniquement)
• Obtenir la liste des services disponibles : Obtient une liste des services AWS disponibles dans les régions Chine (Chine uniquement)

Prérequis

Configuration requise pour l'installation

1. Installez uv depuis Astral ou le README GitHub
2. Installez Python 3.10 ou une version plus récente en utilisant uv python install 3.10 (ou une version plus récente)

Installation

Kiro	Cursor	VS Code

Configurez le serveur MCP dans la configuration de votre client 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": []
    }
  }
}

Pour la configuration MCP de Kiro, consultez la documentation de Kiro IDE ou la documentation de Kiro CLI pour plus de détails.

Pour une configuration globale, modifiez ~/.kiro/settings/mcp.json. Pour une configuration spécifique au projet, modifiez .kiro/settings/mcp.json dans le répertoire de votre projet.

Installation sous Windows

Pour les utilisateurs de Windows, le format de configuration du serveur MCP est légèrement différent :

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

Remarque : Définissez AWS_DOCUMENTATION_PARTITION sur aws-cn pour interroger la documentation AWS Chine au lieu de la documentation AWS mondiale.

Réseaux d'entreprise : Si vous êtes derrière un proxy d'entreprise ou un pare-feu qui bloque certaines chaînes User-Agent, définissez MCP_USER_AGENT pour qu'il corresponde au User-Agent de votre navigateur avec une chaîne autorisée.

ou docker après un docker build -t mcp/aws-documentation . réussi :

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

Variables d'environnement

Variable	Description	Valeur par défaut
FASTMCP_LOG_LEVEL	Niveau de journalisation (DEBUG, INFO, WARNING, ERROR, CRITICAL)	WARNING
AWS_DOCUMENTATION_PARTITION	Partition AWS (aws ou aws-cn)	aws
MCP_USER_AGENT	Chaîne User-Agent personnalisée pour les requêtes HTTP	Valeur par défaut basée sur Chrome

Prise en charge des réseaux d'entreprise

Pour les environnements d'entreprise avec des serveurs proxy ou des pare-feu qui bloquent certaines chaînes 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"
  }
}

Utilisation de base

Exemple :

• "recherche de la documentation sur les règles de nommage des buckets S3. citez vos sources"
• "recommander du contenu pour la page https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html"

Outils

read_documentation

Récupère une page de documentation AWS et la convertit au format markdown.

read_documentation(url: str) -> str

search_documentation (mondial uniquement)

Recherche dans la documentation AWS à l'aide de l'API officielle de recherche de documentation AWS.

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

read_sections (mondial uniquement)

Récupère des sections d'une page de documentation AWS et les convertit au format markdown.

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

search_table (mondial uniquement)

Recherche des lignes spécifiques dans de grands tableaux de documentation (par exemple, quotas de service, tableaux de tarification, modèles pris en charge). Plus efficace que read_sections pour les pages contenant des centaines de lignes de tableau — renvoie les lignes correspondantes sous forme de JSON structuré au lieu du tableau complet.

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

recommend (mondial uniquement)

Obtient des recommandations de contenu pour une page de documentation AWS.

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

get_available_services (Chine uniquement)

Obtient une liste des services AWS disponibles dans les régions Chine.

get_available_services() -> str

Développement

Pour commencer le développement sur le serveur MCP Documentation AWS, veuillez d'abord vous référer au GUIDE_DÉVELOPPEUR awslabs/mcp. Tout ce qui suit est spécifique au développement du serveur MCP Documentation AWS.

Exécution des tests

Tests unitaires : uv run --frozen pytest --cov --cov-branch --cov-report=term-missing Tests unitaires avec tests d'intégration : uv run --frozen pytest --cov --cov-branch --cov-report=term-missing --run-live