tech-icons

MCP server exposing 3100+ cloud technology icons (AWS, Azure, GCP, Microsoft) as searchable tools. Features 3-tier search (exact → keyword → fuzzy → semantic), multiple output formats, and integrations with ppt-master and architecture diagram generators.

Quick Start

End users (PyPI / uvx)

The published wheel bundles the icon catalog and SVGs—no local build step.

uvx tech-icons

uvx --with 'tech-icons[semantic]' tech-icons

uvx --with 'tech-icons[web]' tech-icons --web

Run from this repository without a PyPI release:

uvx --from git+https://github.com/zhiweio/tech-icons tech-icons

MCP Configuration

Add to your .mcp.json or MCP client config:

{
  "mcpServers": {
    "tech-icons": {
      "command": "uvx",
      "args": ["tech-icons"],
      "env": {}
    }
  }
}

For semantic search, use "args": ["--with", "tech-icons[semantic]", "tech-icons"] with "command": "uvx" (or install tech-icons[semantic] in your environment).

Related MCP server: Iconify-Icon

Web UI

uvx --with 'tech-icons[web]' tech-icons --web --port 8765 --open

Opens the local icon browser at http://127.0.0.1:8765 (loopback only).

Available Tools

Format Options

Icon IDs

Canonical format: {vendor}/{category}/{name}

Examples: aws/compute/lambda, azure/databases/cosmos-db, gcp/containers/gke, microsoft/365/teams

Integrations

ppt-master: Use format="ppt_master" or the bridge script to export icons into ppt-master template directories.

python3 -m tech_icons.bridges.ppt_master --icons aws/compute/lambda,gcp/compute/cloud-run --target ./templates/icons/tech/

Architecture diagrams: Use format="data_uri" for HTML img tags or format="inline_group" for direct SVG composition. See docs/integration-arch-diagram.md.

Development

Requires uv for dependency management.

# Install with dev dependencies
uv sync --group dev

# Format code
make format

# Lint
make lint

# Type check
make typecheck

# All checks (lint + typecheck)
make check

# Run tests
make test

# Format + lint + typecheck + test
make all

Other useful commands:

# Start MCP server
make serve

# Local icon browser
make web

Tooling

• Formatter/Linter: ruff (line-length: 120)

• Type checker: mypy (disallow-untyped-defs)

• Tests: pytest + pytest-asyncio