clouddocs

clouddocs

clouddocs は AWS ドキュメントの閲覧室です。AWS の公式ドキュメントインデックスからフレーズを検索し、ドキュメントページを開いて、スライス単位でページを進められる整形済みの Markdown 風テキストとして返します。また、そのページから参照されている関連ドキュメントページを提案します。コマンドラインから、またはエージェント向けの MCP サーバーとして利用でき、AWS アカウントや API キーは不要です。読み取り対象はすべて公開ドキュメントサイトです。

読み取りとおすすめの対象として受け付けるのは、AWS ドキュメントのアドレス（docs.aws.amazon.com、aws.amazon.com およびそのサブドメイン）のみです。それ以外のホストは、リクエストを送信する前に拒否されます。

インストール

npx @reneturcios/clouddocs search "s3 bucket naming"

または、コンテナイメージを実行します。

docker run -i ghcr.io/cloudcorprecords/clouddocs

コンテナはデフォルトで MCP サーバーとして動作します（下記を参照）。CLI として使用するには、CLI の引数を渡してください。

CLI

# Search the documentation index
clouddocs search "s3 bucket naming rules"
clouddocs search "lambda execution role" --limit 5 --json

# Read a page as markdown-style text, optionally one window of it
clouddocs read https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html
clouddocs read https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html --start-index 5000 --max-length 5000

# Related pages for a documentation page
clouddocs recommend https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html

clouddocs --version

終了コード：成功時は 0、検索または取得の失敗時は 1（エラー内容が表示されます）、使い方の誤り時は 2 です。

MCP サーバー

1 つの実行ファイルで両方の用途に対応します。mcp サブコマンドを実行すると、stdio MCP サーバーが起動します。

npx -y @reneturcios/clouddocs mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "clouddocs": {
      "command": "npx",
      "args": ["-y", "@reneturcios/clouddocs", "mcp"]
    }
  }
}

ツール

ツール	入力	戻り値
search_documentation	search_phrase（文字列、必須）、limit（整数、任意）	条件に一致するドキュメントページ：各ページのタイトル、URL、短い概要。検索は公式検索エンドポイント search.docs.aws.amazon.com に対して実行されます。
read_documentation	url（文字列、必須）、max_length（整数、任意）、start_index（整数、任意）	Markdown 風テキストに変換したページ：見出し、リンク、リスト、コードブロックは保持され、ナビゲーションとスクリプトは削除されます。start_index と max_length で変換済みテキストの範囲を指定できるため、長いページをスライス単位で読めます。
recommend	url（文字列、必須）	指定したページからリンクされている AWS ドキュメントページを、順序を保ち重複を除いて返します。

開発

npm install
npm run build   # tsc -> dist/
npm test        # node test runner over test/*.test.ts, no network (fake fetch fixtures)
npm run dev     # run the CLI from source via tsx

ライセンス

MIT — LICENSE を参照してください。