メインコンテンツまでスキップ

AWS Documentation MCPサーバー

AWSドキュメント向けのModel Context Protocol (MCP) サーバーです

このMCPサーバーは、AWSドキュメントへのアクセス、コンテンツの検索、およびレコメンデーションの取得を行うツールを提供します。

機能​

  • ドキュメントの読み取り: AWSドキュメントのページを取得し、markdown形式に変換します
  • ドキュメントの検索: 公式の検索APIを使用してAWSドキュメントを検索します（グローバルのみ）
  • セクションの読み取り: AWSドキュメントページのセクションを取得し、markdown形式に変換します。
  • レコメンデーション: AWSドキュメントページのコンテンツレコメンデーションを取得します（グローバルのみ）
  • 利用可能なサービス一覧の取得: 中国リージョンで利用可能なAWSサービスの一覧を取得します（中国のみ）

前提条件​

インストール要件​

  1. Astral または GitHub README から uv をインストールします
  2. uv python install 3.10 を使用して Python 3.10 以降をインストールします（より新しいバージョンでも構いません）

インストール​

KiroCursorVS Code
Add to KiroInstall MCP ServerInstall on 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ドキュメントではなくAWS中国のドキュメントを照会するには、AWS_DOCUMENTATION_PARTITION を aws-cn に設定してください。

企業ネットワーク: 特定のUser-Agent文字列をブロックする企業のプロキシやファイアウォールの内側にいる場合は、MCP_USER_AGENT をお使いのブラウザのUser-Agentに合わせて許可される文字列に設定してください。

または、docker build -t mcp/aws-documentation . が成功した後に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": []
    }
  }
}

環境変数​

変数説明デフォルト
FASTMCP_LOG_LEVELログレベル (DEBUG, INFO, WARNING, ERROR, CRITICAL)WARNING
AWS_DOCUMENTATION_PARTITIONAWSパーティション（aws または aws-cn）aws
MCP_USER_AGENTHTTPリクエスト用のカスタムUser-Agent文字列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"
  }
}

基本的な使い方​

例:

AWS Documentation MCP Demo

ツール​

read_documentation​

AWSドキュメントのページを取得し、markdown形式に変換します。

read_documentation(url: str) -> str

search_documentation（グローバルのみ）​

公式のAWS Documentation Search 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]

recommend（グローバルのみ）​

AWSドキュメントページのコンテンツレコメンデーションを取得します。

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

get_available_services（中国のみ）​

中国リージョンで利用可能なAWSサービスの一覧を取得します。

get_available_services() -> str

開発​

AWS Documentation MCPサーバーの開発を始めるにあたっては、まず awslabs/mcp の DEVELOPER_GUIDE を参照してください。これより下の内容は、AWS Documentation MCPサーバーの開発に固有のものです。

テストの実行​

ユニットテスト: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing 統合テストを含むユニットテスト: uv run --frozen pytest --cov --cov-branch --cov-report=term-missing --run-live