GearScope smoke-test log: awslabs/mcp
Tested: 2026-06-30
Host: macOS (host) aarch64
Method: clone + uvx install + reusable MCP stdio client (host-based, no sbx microVM)
Repo: https://github.com/awslabs/mcp  (9,356 stars, 1,609 forks, Apache-2.0)

============================================================
RUN: install + MCP handshake (flagship aws-documentation-mcp-server)
============================================================
$ git clone --depth 1 https://github.com/awslabs/mcp.git  -> 88M, 61 servers in src/
$ uvx --python 3.12 awslabs.aws-documentation-mcp-server@latest --help
   Downloaded 42 packages in 122ms  (exit 0; FastMCP prints no --help text)

$ python3 mcp-stdio-client.py uvx --python 3.12 -- awslabs.aws-documentation-mcp-server@latest
=== INITIALIZE ===
serverInfo: {"name": "awslabs.aws-documentation-mcp-server", "version": "1.28.1"}
protocolVersion: 2024-11-05
capabilities: ['experimental', 'prompts', 'resources', 'tools']
=== TOOLS/LIST ===
tool count: 4
first 12 names: ['read_documentation', 'read_sections', 'search_documentation', 'recommend']
=== RESOURCES/LIST ===
resources count: 0
=== PROMPTS/LIST ===
prompts count: 0

NOTE on version: serverInfo reports 1.28.1 which is the mcp[cli] SDK version,
NOT the package version. The package is 1.1.26 (PyPI + pyproject.toml).
FastMCP() is instantiated without an explicit version=, so it surfaces the SDK version.
Confirmed: importlib.metadata.version('awslabs.aws-documentation-mcp-server') = 1.1.26
          importlib.metadata.version('mcp') = 1.28.1

VERDICT: PASS (handshake + tools/list)

============================================================
RUN: functional tool call -> search_documentation
============================================================
$ mcp-client.py --call search_documentation --args '{"search_phrase":"S3 bucket naming","limit":3}'
=== CALL search_documentation ===
isError: False, content blocks: 1
   {
  "search_results": [
    {
      "rank_order": 1,
      "url": "https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html",
      "title": "General purpose bucket naming rules - Amazon Simple Storage Service",
      "context": "S3 bucket naming rules cover length, characters, u..."

VERDICT: PASS (live AWS docs search returned ranked results)

============================================================
RUN: functional tool call -> read_documentation
============================================================
$ mcp-client.py --call read_documentation --args '{"url":"https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html"}'
=== CALL read_documentation ===
isError: False, content blocks: 1
   AWS Documentation from https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html:

   # General purpose bucket naming rules

   When you create a general purpose bucket, make sure that you consider the length, valid characters,
   formatting, and uniqueness of bucket names. The following s...

VERDICT: PASS (real page fetched + converted to markdown)

============================================================
STRUCTURAL: repo-wide
============================================================
- 61 MCP servers in src/ (58 with pyproject.toml)
- 1,028 test_*.py files
- 1,072 source .py files (excluding tests)
- README.md: 1,071 lines
- Security tooling: .gitleaks.toml, trivy.yaml, .pre-commit-config.yaml, .secrets.baseline (38KB)
- DESIGN_GUIDELINES.md: 1,096 lines; DEVELOPER_GUIDE.md: 123 lines; CONTRIBUTING.md: 54 lines
- 10 migration docs (docs/migration-*.md) -> paths to the successor Agent Toolkit for AWS
- 2 servers marked DEPRECATED (ccapi-mcp-server -> use aws-iac-mcp-server instead)
- Latest release tag: 2026.06.20260625003520 (2026-06-25)
- PyPI: awslabs.aws-documentation-mcp-server 1.1.26 (published 2026-06-25), Apache-2.0

OVERALL: 3/3 PASS. Functional verification = YES (two live tool calls returned real AWS data).