Skip to content

Add MCP Servers tab to GitHub Pages site - #49

Merged
udid-aws merged 2 commits into
mainfrom
docs/add-mcp-servers-section
Aug 13, 2026
Merged

Add MCP Servers tab to GitHub Pages site#49
udid-aws merged 2 commits into
mainfrom
docs/add-mcp-servers-section

Conversation

@udid-aws

Copy link
Copy Markdown
Contributor
  • Add mcp_catalog.py hook that scans mcp/*/README.md at build time
  • Add MCP Servers catalog index page with dynamic card rendering
  • Extend catalog.js with MCP server card rendering
  • Add #mcp-catalog CSS grid layout
  • Add MCP Servers nav entry and homepage references
  • Add .gitignore entries for generated MCP files

Description

Type of change

  • New skill
  • New custom agent
  • Update to an existing skill or agent
  • Documentation or infrastructure change

Testing

This is a change for the GitHub Pages site. I validated it by running mkdocs server and browsing through the site to make sure the changes work and there are no regressions.
For the reviewer to review the changes locally, including running a local version of the GitHub Pages site, follow the below:

# Check out the branch
git fetch origin
git checkout docs/add-mcp-servers-section

# Install dependencies (if not already installed)
pip install mkdocs-material

# Preview the site locally
mkdocs serve

License confirmation

  • By submitting this pull request, I confirm that my contribution is made under the terms of the Apache License 2.0.

- Add mcp_catalog.py hook that scans mcp/*/README.md at build time
- Add MCP Servers catalog index page with dynamic card rendering
- Extend catalog.js with MCP server card rendering
- Add #mcp-catalog CSS grid layout
- Add MCP Servers nav entry and homepage references
- Add .gitignore entries for generated MCP files
Comment thread docs/javascripts/catalog.js Fixed
Replace escapeText() with encodeURIComponent() when building card
link hrefs. escapeText uses div.textContent which is an HTML escape,
not a URL-safe encoding. encodeURIComponent ensures the id is a safe
URL path segment, addressing the js/xss-through-dom CodeQL alert.

Applied to all three catalog card functions (skills, agents, MCP).
@udid-aws
udid-aws merged commit 324c993 into main Aug 13, 2026
4 checks passed
@udid-aws
udid-aws deleted the docs/add-mcp-servers-section branch August 13, 2026 08:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants