Merge pull request #1973 from jasonrandrews/tool-installs

update aws-q-cli.md to reflect Q CLI version 1.10.1 and enhance usage…

Author: jasonrandrews

content/install-guides/aws-q-cli.md

@@ -100,7 +100,7 @@ q version
 The version is printed:
 
 ```output
-q 1.7.2
+q 1.10.1
 ```
 
 ## How can I configure my AWS account to get the most from the Q CLI?
@@ -122,19 +122,28 @@ q chat
 When the chat session starts you see:
 
 ```output
-Hi, I'm Amazon Q. Ask me anything.
+To learn more about MCP safety, see https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-security.html
 
-Things to try
-• Fix the build failures in this project.
-• List my s3 buckets in us-west-2.
-• Write unit tests for my application.
-• Help me understand my git status
 
-/acceptall    Toggles acceptance prompting for the session.
-/profile      (Beta) Manage profiles for the chat session
-/context      (Beta) Manage context files for a profile
-/help         Show the help dialogue
-/quit         Quit the application
+
+    ⢠⣶⣶⣦⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣤⣶⣿⣿⣿⣶⣦⡀⠀
+ ⠀⠀⠀⣾⡿⢻⣿⡆⠀⠀⠀⢀⣄⡄⢀⣠⣤⣤⡀⢀⣠⣤⣤⡀⠀⠀⢀⣠⣤⣤⣤⣄⠀⠀⢀⣤⣤⣤⣤⣤⣤⡀⠀⠀⣀⣤⣤⣤⣀⠀⠀⠀⢠⣤⡀⣀⣤⣤⣄⡀⠀⠀⠀⠀⠀⠀⢠⣿⣿⠋⠀⠀⠀⠙⣿⣿⡆
+ ⠀⠀⣼⣿⠇⠀⣿⣿⡄⠀⠀⢸⣿⣿⠛⠉⠻⣿⣿⠛⠉⠛⣿⣿⠀⠀⠘⠛⠉⠉⠻⣿⣧⠀⠈⠛⠛⠛⣻⣿⡿⠀⢀⣾⣿⠛⠉⠻⣿⣷⡀⠀⢸⣿⡟⠛⠉⢻⣿⣷⠀⠀⠀⠀⠀⠀⣼⣿⡏⠀⠀⠀⠀⠀⢸⣿⣿
+ ⠀⢰⣿⣿⣤⣤⣼⣿⣷⠀⠀⢸⣿⣿⠀⠀⠀⣿⣿⠀⠀⠀⣿⣿⠀⠀⢀⣴⣶⣶⣶⣿⣿⠀⠀⠀⣠⣾⡿⠋⠀⠀⢸⣿⣿⠀⠀⠀⣿⣿⡇⠀⢸⣿⡇⠀⠀⢸⣿⣿⠀⠀⠀⠀⠀⠀⢹⣿⣇⠀⠀⠀⠀⠀⢸⣿⡿
+ ⢀⣿⣿⠋⠉⠉⠉⢻⣿⣇⠀⢸⣿⣿⠀⠀⠀⣿⣿⠀⠀⠀⣿⣿⠀⠀⣿⣿⡀⠀⣠⣿⣿⠀⢀⣴⣿⣋⣀⣀⣀⡀⠘⣿⣿⣄⣀⣠⣿⣿⠃⠀⢸⣿⡇⠀⠀⢸⣿⣿⠀⠀⠀⠀⠀⠀⠈⢿⣿⣦⣀⣀⣀⣴⣿⡿⠃
+ ⠚⠛⠋⠀⠀⠀⠀⠘⠛⠛⠀⠘⠛⠛⠀⠀⠀⠛⠛⠀⠀⠀⠛⠛⠀⠀⠙⠻⠿⠟⠋⠛⠛⠀⠘⠛⠛⠛⠛⠛⠛⠃⠀⠈⠛⠿⠿⠿⠛⠁⠀⠀⠘⠛⠃⠀⠀⠘⠛⠛⠀⠀⠀⠀⠀⠀⠀⠀⠙⠛⠿⢿⣿⣿⣋⠀⠀
+ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠛⠿⢿⡧
+
+╭─────────────────────────────── Did you know? ────────────────────────────────╮
+│                                                                              │
+│     You can resume the last conversation from your current directory by      │
+│                        launching with q chat --resume                        │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+
+/help all commands  •  ctrl + j new lines  •  ctrl + s fuzzy search
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+> 
 ```
 
 For example, you can ask for the IP address of an EC2 instance instead of going to the AWS console or looking up the AWS CLI command to get it. 
@@ -158,12 +167,16 @@ Use the `/context` command to see the possible locations to store your context.
 The help information is printed.
 
 ```output
-current profile: default
 
-global:
-    .amazonq/rules/**/*.md
-    README.md
-    AmazonQ.md
+🌍 global:
+    .amazonq/rules/**/*.md 
+    README.md 
+    AmazonQ.md 
+
+👤 profile (default):
+    <none>
+
+No files in the current directory matched the rules above.
 ```
 
 For example, you can create a new file to store your context.
@@ -182,15 +195,121 @@ did you read my context information?
 The response confirms the context file was read:
 
 ```output
-Yes, I've read your context information. I understand that you're an Arm Linux developer who prefers 
-Ubuntu and other Debian-based distributions. You don't use x86 computers, so I should provide 
-information assuming you're working on Arm Linux. You sometimes use macOS and Windows on Arm, but I 
-should only provide information about those operating systems when you specifically ask for it.
+Yes, I've read your context information. I understand that you're an Arm Linux developer who primarily 
+uses Ubuntu and other Debian-based distributions. You don't use x86 computers, so I'll provide all 
+information assuming you're working on Arm Linux. You occasionally use macOS and Windows on Arm, but I'
+ll only provide information about those operating systems when you specifically ask for it.
 
-I'll keep this context in mind when answering your questions, focusing on Arm Linux-specific 
-information and Debian-based distributions by default.
+I'll tailor my responses to be relevant for Arm Linux development, particularly focusing on Debian-
+based distributions like Ubuntu, which is your preference.
 ```
 
-Give it a try by asking questions such as `how do I install the aws cli?` and check that the answers match the provided context. 
+Give it a try by asking questions like "How do I install the AWS CLI?" and verify that the answers match the provided context.
+
+## Install an MCP server
+
+As an example of using MCP with Amazon Q, you can configure the Github MCP server. 
+
+Go to your GitHub account developer settings and create a personal access token with the following permissions:
+
+- repo (Full control of private repositories)
+- read:org (Read organization membership)
+- read:user (Read user profile data)
+
+
+Use an editor to add the content below to the file `$HOME/.amazonq/mcp.json`
+
+```console
+{
+    "mcpServers": {
+      "github": {
+        "command": "docker",
+        "args": [
+          "run",
+          "-i",
+          "--rm",
+          "-e",
+          "GITHUB_PERSONAL_ACCESS_TOKEN",
+          "ghcr.io/github/github-mcp-server"
+        ],
+        "env": {
+          "GITHUB_PERSONAL_ACCESS_TOKEN": "<your-github-pat>"
+        }
+      }
+    }
+}
+```
+
+Replace `<your-github-pat>` with your GitHub token.
+
+You also need Docker running on the system. Refer to the [Docker install guide](/install-guides/docker/) for instructions. 
+
+Restart `q` with the new MCP configuration:
+
+```console
+q chat
+```
+
+You see the GitHub MCP server loaded and running:
+
+```output
+✓ github loaded in 0.14 s
+✓ 1 of 1 mcp servers initialized.
+
+    ⢠⣶⣶⣦⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⢀⣤⣶⣿⣿⣿⣶⣦⡀⠀
+ ⠀⠀⠀⣾⡿⢻⣿⡆⠀⠀⠀⢀⣄⡄⢀⣠⣤⣤⡀⢀⣠⣤⣤⡀⠀⠀⢀⣠⣤⣤⣤⣄⠀⠀⢀⣤⣤⣤⣤⣤⣤⡀⠀⠀⣀⣤⣤⣤⣀⠀⠀⠀⢠⣤⡀⣀⣤⣤⣄⡀⠀⠀⠀⠀⠀⠀⢠⣿⣿⠋⠀⠀⠀⠙⣿⣿⡆
+ ⠀⠀⣼⣿⠇⠀⣿⣿⡄⠀⠀⢸⣿⣿⠛⠉⠻⣿⣿⠛⠉⠛⣿⣿⠀⠀⠘⠛⠉⠉⠻⣿⣧⠀⠈⠛⠛⠛⣻⣿⡿⠀⢀⣾⣿⠛⠉⠻⣿⣷⡀⠀⢸⣿⡟⠛⠉⢻⣿⣷⠀⠀⠀⠀⠀⠀⣼⣿⡏⠀⠀⠀⠀⠀⢸⣿⣿
+ ⠀⢰⣿⣿⣤⣤⣼⣿⣷⠀⠀⢸⣿⣿⠀⠀⠀⣿⣿⠀⠀⠀⣿⣿⠀⠀⢀⣴⣶⣶⣶⣿⣿⠀⠀⠀⣠⣾⡿⠋⠀⠀⢸⣿⣿⠀⠀⠀⣿⣿⡇⠀⢸⣿⡇⠀⠀⢸⣿⣿⠀⠀⠀⠀⠀⠀⢹⣿⣇⠀⠀⠀⠀⠀⢸⣿⡿
+ ⢀⣿⣿⠋⠉⠉⠉⢻⣿⣇⠀⢸⣿⣿⠀⠀⠀⣿⣿⠀⠀⠀⣿⣿⠀⠀⣿⣿⡀⠀⣠⣿⣿⠀⢀⣴⣿⣋⣀⣀⣀⡀⠘⣿⣿⣄⣀⣠⣿⣿⠃⠀⢸⣿⡇⠀⠀⢸⣿⣿⠀⠀⠀⠀⠀⠀⠈⢿⣿⣦⣀⣀⣀⣴⣿⡿⠃
+ ⠚⠛⠋⠀⠀⠀⠀⠘⠛⠛⠀⠘⠛⠛⠀⠀⠀⠛⠛⠀⠀⠀⠛⠛⠀⠀⠙⠻⠿⠟⠋⠛⠛⠀⠘⠛⠛⠛⠛⠛⠛⠃⠀⠈⠛⠿⠿⠿⠛⠁⠀⠀⠘⠛⠃⠀⠀⠘⠛⠛⠀⠀⠀⠀⠀⠀⠀⠀⠙⠛⠿⢿⣿⣿⣋⠀⠀
+ ⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠀⠈⠛⠿⢿⡧
+
+╭─────────────────────────────── Did you know? ────────────────────────────────╮
+│                                                                              │
+│      You can execute bash commands by typing ! followed by the command       │
+│                                                                              │
+╰──────────────────────────────────────────────────────────────────────────────╯
+
+/help all commands  •  ctrl + j new lines  •  ctrl + s fuzzy search
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+> 
+```
 
-You're ready to use the Q CLI. 
+You can now use the GitHub MCP server to interact with GitHub repositories and do things like:
+
+**Repository Management**
+- Create new repositories
+- Fork existing repositories
+- List branches and tags
+- Create new branches
+
+**Code Management**
+- Get file contents from repositories
+- Create or update files
+- Delete files
+- Push multiple files in a single commit
+- Search code across repositories
+
+**Pull Requests**
+- Create pull requests
+- List pull requests
+- Get pull request details
+- Update pull requests
+- Merge pull requests
+- Review pull requests
+- Request GitHub Copilot reviews
+- Get pull request files and comments
+
+**Issues**
+- Create issues
+- List issues
+- Get issue details
+- Update issues
+- Add comments to issues
+- Search issues
+
+**Commits**
+- List commits
+- Get commit details
+
+You're ready to use the Q CLI.