clouddocs

clouddocs is a reading room for AWS documentation. It searches the official AWS documentation index for a phrase, opens a documentation page and returns it as clean markdown-style text you can page through in slices, and suggests the related documentation pages a page points to. It works from the command line or as an MCP server for agents, and it needs no AWS account and no API key: everything it reads is the public documentation site.

Only AWS documentation addresses are accepted for reading and recommendations — docs.aws.amazon.com, aws.amazon.com, and their subdomains. Any other host is refused before a request is made.

Install

npx @reneturcios/clouddocs search "s3 bucket naming"

Or run the container image:

docker run -i ghcr.io/cloudcorprecords/clouddocs

The container defaults to the MCP server (see below). Pass CLI arguments to use it as a CLI instead.

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

Exit codes: 0 on success, 1 when a search or fetch fails (the error names the problem), 2 for usage errors.

MCP server

One bin serves both faces. The mcp subcommand starts a stdio MCP server:

npx -y @reneturcios/clouddocs mcp

MCP client configuration:

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

Tools

Development

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

License

MIT — see LICENSE.