pcp-mcp 0.1.0__tar.gz → 1.0.1__tar.gz

{pcp_mcp-0.1.0 → pcp_mcp-1.0.1}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: pcp-mcp
-Version: 0.1.0
+Version: 1.0.1
 Summary: MCP server for Performance Co-Pilot
 Keywords: mcp,pcp,performance-co-pilot,monitoring,model-context-protocol
 Author: Major Hayden
 Author-email: Major Hayden <major@mhtx.net>
 License-Expression: MIT
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: System Administrators
 Classifier: License :: OSI Approved :: MIT License
@@ -17,6 +17,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: System :: Monitoring
 Classifier: Typing :: Typed
+Requires-Dist: cachetools>=5.0
 Requires-Dist: fastmcp>=2.0.0
 Requires-Dist: httpx>=0.27
 Requires-Dist: pydantic-settings>=2.0.0
@@ -32,6 +33,14 @@ MCP server for [Performance Co-Pilot (PCP)](https://pcp.io/) metrics.
 
 Query system performance metrics via the Model Context Protocol - CPU, memory, disk I/O, network, processes, and more.
 
+📖 **[Full Documentation](https://major.github.io/pcp-mcp)** | 🚀 **[Getting Started](https://major.github.io/pcp-mcp/getting-started/)**
+
+[![CI](https://github.com/major/pcp-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/major/pcp-mcp/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/major/pcp-mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/major/pcp-mcp)
+[![PyPI version](https://badge.fury.io/py/pcp-mcp.svg)](https://pypi.org/project/pcp-mcp/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 ## 🚀 Installation
 
 ```bash
@@ -47,15 +56,15 @@ uv add pcp-mcp
 ## 📋 Requirements
 
 - **Python**: 3.10+
-- **PCP**: Performance Co-Pilot with `pmproxy` running
+- **PCP**: Performance Co-Pilot with `pmcd` and `pmproxy` running
   ```bash
   # Fedora/RHEL/CentOS
   sudo dnf install pcp
-  sudo systemctl enable --now pmproxy
+  sudo systemctl enable --now pmcd pmproxy
   
   # Ubuntu/Debian
   sudo apt install pcp
-  sudo systemctl enable --now pmproxy
+  sudo systemctl enable --now pmcd pmproxy
   ```
 
 ## ⚙️ Configuration
@@ -68,9 +77,12 @@ Configure via environment variables:
 | `PCP_PORT` | pmproxy port | `44322` |
 | `PCP_TARGET_HOST` | Target pmcd host to monitor | `localhost` |
 | `PCP_USE_TLS` | Use HTTPS for pmproxy | `false` |
+| `PCP_TLS_VERIFY` | Verify TLS certificates | `true` |
+| `PCP_TLS_CA_BUNDLE` | Path to custom CA bundle | (optional) |
 | `PCP_TIMEOUT` | Request timeout (seconds) | `30` |
 | `PCP_USERNAME` | HTTP basic auth user | (optional) |
 | `PCP_PASSWORD` | HTTP basic auth password | (optional) |
+| `PCP_ALLOWED_HOSTS` | Hostspecs allowed via host param | (optional) |
 
 ## 🎯 Usage
 
@@ -163,9 +175,9 @@ For remote monitoring:
 
 Browse metrics via MCP resources:
 
-- `pcp://metrics` - List all available metrics (grouped by prefix)
-- `pcp://system/snapshot` - Latest system snapshot
-- `pcp://processes/top` - Top processes
+- `pcp://health` - Quick system health summary
+- `pcp://metrics/common` - Catalog of commonly used metrics
+- `pcp://namespaces` - Live-discovered metric namespaces
 
 ## 💡 Use Cases
 
@@ -191,9 +203,9 @@ Ask Claude to:
 ## 🏗️ Architecture
 
 ```
-┌─────────┐         ┌─────────┐         ┌─────────┐         ┌─────────┐
+┌─────────┐         ┌─────────┐          ┌─────────┐         ┌─────────┐
 │   LLM   │ ◄─MCP─► │ pcp-mcp │ ◄─HTTP─► │ pmproxy │ ◄─────► │  pmcd   │
-└─────────┘         └─────────┘         └─────────┘         └─────────┘
+└─────────┘         └─────────┘          └─────────┘         └─────────┘
                                          (REST API)          (metrics)
 ```
 

{pcp_mcp-0.1.0 → pcp_mcp-1.0.1}/README.md

@@ -4,6 +4,14 @@ MCP server for [Performance Co-Pilot (PCP)](https://pcp.io/) metrics.
 
 Query system performance metrics via the Model Context Protocol - CPU, memory, disk I/O, network, processes, and more.
 
+📖 **[Full Documentation](https://major.github.io/pcp-mcp)** | 🚀 **[Getting Started](https://major.github.io/pcp-mcp/getting-started/)**
+
+[![CI](https://github.com/major/pcp-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/major/pcp-mcp/actions/workflows/ci.yml)
+[![codecov](https://codecov.io/gh/major/pcp-mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/major/pcp-mcp)
+[![PyPI version](https://badge.fury.io/py/pcp-mcp.svg)](https://pypi.org/project/pcp-mcp/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 ## 🚀 Installation
 
 ```bash
@@ -19,15 +27,15 @@ uv add pcp-mcp
 ## 📋 Requirements
 
 - **Python**: 3.10+
-- **PCP**: Performance Co-Pilot with `pmproxy` running
+- **PCP**: Performance Co-Pilot with `pmcd` and `pmproxy` running
   ```bash
   # Fedora/RHEL/CentOS
   sudo dnf install pcp
-  sudo systemctl enable --now pmproxy
+  sudo systemctl enable --now pmcd pmproxy
   
   # Ubuntu/Debian
   sudo apt install pcp
-  sudo systemctl enable --now pmproxy
+  sudo systemctl enable --now pmcd pmproxy
   ```
 
 ## ⚙️ Configuration
@@ -40,9 +48,12 @@ Configure via environment variables:
 | `PCP_PORT` | pmproxy port | `44322` |
 | `PCP_TARGET_HOST` | Target pmcd host to monitor | `localhost` |
 | `PCP_USE_TLS` | Use HTTPS for pmproxy | `false` |
+| `PCP_TLS_VERIFY` | Verify TLS certificates | `true` |
+| `PCP_TLS_CA_BUNDLE` | Path to custom CA bundle | (optional) |
 | `PCP_TIMEOUT` | Request timeout (seconds) | `30` |
 | `PCP_USERNAME` | HTTP basic auth user | (optional) |
 | `PCP_PASSWORD` | HTTP basic auth password | (optional) |
+| `PCP_ALLOWED_HOSTS` | Hostspecs allowed via host param | (optional) |
 
 ## 🎯 Usage
 
@@ -135,9 +146,9 @@ For remote monitoring:
 
 Browse metrics via MCP resources:
 
-- `pcp://metrics` - List all available metrics (grouped by prefix)
-- `pcp://system/snapshot` - Latest system snapshot
-- `pcp://processes/top` - Top processes
+- `pcp://health` - Quick system health summary
+- `pcp://metrics/common` - Catalog of commonly used metrics
+- `pcp://namespaces` - Live-discovered metric namespaces
 
 ## 💡 Use Cases
 
@@ -163,9 +174,9 @@ Ask Claude to:
 ## 🏗️ Architecture
 
 ```
-┌─────────┐         ┌─────────┐         ┌─────────┐         ┌─────────┐
+┌─────────┐         ┌─────────┐          ┌─────────┐         ┌─────────┐
 │   LLM   │ ◄─MCP─► │ pcp-mcp │ ◄─HTTP─► │ pmproxy │ ◄─────► │  pmcd   │
-└─────────┘         └─────────┘         └─────────┘         └─────────┘
+└─────────┘         └─────────┘          └─────────┘         └─────────┘
                                          (REST API)          (metrics)
 ```
 

{pcp_mcp-0.1.0 → pcp_mcp-1.0.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pcp-mcp"
-version = "0.1.0"
+version = "1.0.1"
 description = "MCP server for Performance Co-Pilot"
 readme = "README.md"
 license = "MIT"
@@ -8,7 +8,7 @@ authors = [{ name = "Major Hayden", email = "major@mhtx.net" }]
 requires-python = ">=3.10"
 keywords = ["mcp", "pcp", "performance-co-pilot", "monitoring", "model-context-protocol"]
 classifiers = [
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
     "Intended Audience :: System Administrators",
     "License :: OSI Approved :: MIT License",
@@ -21,6 +21,7 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
+    "cachetools>=5.0",
     "fastmcp>=2.0.0",
     "httpx>=0.27",
     "pydantic-settings>=2.0.0",
@@ -50,6 +51,7 @@ dev = [
     "pytest-randomly>=4.0.1",
     "mkdocs-material>=9.5",
     "mkdocstrings[python]>=0.27",
+    "commitizen>=4.0",
 ]
 
 [tool.uv.build-backend]
@@ -66,6 +68,7 @@ ignore = [
     "D104", # Missing docstring in public package
     "D105", # Missing docstring in magic method
     "D107", # Missing docstring in __init__
+    "UP045", # Optional[X] vs X | None - Pydantic needs Optional in Annotated params
 ]
 
 [tool.ruff.lint.per-file-ignores]
@@ -102,3 +105,12 @@ pythonPlatform = "Linux"
 venvPath = "."
 venv = ".venv"
 typeCheckingMode = "standard"
+
+[tool.commitizen]
+name = "cz_conventional_commits"
+version_provider = "pep621"
+tag_format = "v$version"
+update_changelog_on_bump = true
+changelog_file = "CHANGELOG.md"
+changelog_incremental = true
+bump_message = "bump: version $current_version → $new_version"

pcp_mcp-1.0.1/src/pcp_mcp/AGENTS.md

@@ -0,0 +1,70 @@
+# pcp_mcp Core Package
+
+## OVERVIEW
+
+Core MCP server package. Entry point, HTTP client, configuration, models, error handling.
+
+## STRUCTURE
+
+```
+pcp_mcp/
+├── __init__.py     # CLI entry (main() with argparse)
+├── server.py       # FastMCP setup, lifespan context
+├── client.py       # PCPClient async httpx wrapper
+├── config.py       # PCPMCPSettings (Pydantic)
+├── models.py       # Response models (SystemSnapshot, ProcessInfo, etc.)
+├── errors.py       # Exception → ToolError mapping
+├── context.py      # get_client(), get_settings() helpers
+├── middleware.py   # Request caching middleware
+├── icons.py        # System assessment icons (emoji mappings)
+├── tools/          # MCP tools (see tools/AGENTS.md)
+├── resources/      # MCP resources (health.py, catalog.py)
+├── utils/          # Extractors, builders
+└── prompts/        # LLM system prompts
+```
+
+## KEY PATTERNS
+
+### Server Lifespan
+```python
+@asynccontextmanager
+async def lifespan(mcp: FastMCP) -> AsyncIterator[dict]:
+    async with PCPClient(...) as client:
+        yield {"client": client, "settings": settings}
+```
+Tools access via `ctx.request_context.lifespan_context["client"]`.
+
+### Client Rate Calculation
+`fetch_with_rates()` takes two samples, calculates per-second rates for counters.
+Handles counter wrap-around (reset to 0) gracefully.
+
+### Error Mapping
+```python
+try:
+    result = await client.fetch(names)
+except Exception as e:
+    raise handle_pcp_error(e, "fetching metrics") from e
+```
+
+### Configuration
+Pydantic settings with `env_prefix="PCP_"`. Computed properties: `base_url`, `auth`.
+
+## WHERE TO LOOK
+
+| Task | File | Notes |
+|------|------|-------|
+| Add CLI flag | `__init__.py` | argparse in `main()` |
+| Change transport | `__init__.py` | `server.run(transport=...)` |
+| Add env var | `config.py` | Add field with `Field(default=...)` |
+| New response type | `models.py` | Inherit `BaseModel` |
+| Map new exception | `errors.py` | Add case to `handle_pcp_error()` |
+| Access client in tool | `context.py` | Use `get_client(ctx)` |
+| Add caching | `middleware.py` | Request caching layer |
+| System icons | `icons.py` | Assessment emoji mappings |
+
+## ANTI-PATTERNS
+
+- **NEVER** call `client.fetch()` for counter metrics expecting rates
+- **NEVER** use client outside `async with` context
+- **NEVER** log credentials from settings
+- **ALWAYS** use `handle_pcp_error()` for exception wrapping

{pcp_mcp-0.1.0 → pcp_mcp-1.0.1}/src/pcp_mcp/__init__.py

@@ -17,9 +17,13 @@ Environment Variables:
   PCP_PORT          pmproxy port (default: 44322)
   PCP_TARGET_HOST   Target pmcd host to monitor (default: localhost)
   PCP_USE_TLS       Use HTTPS for pmproxy connection (default: false)
+  PCP_TLS_VERIFY    Verify TLS certificates (default: true)
+  PCP_TLS_CA_BUNDLE Path to custom CA bundle for TLS (optional)
   PCP_TIMEOUT       Request timeout in seconds (default: 30)
   PCP_USERNAME      HTTP basic auth user (optional)
   PCP_PASSWORD      HTTP basic auth password (optional)
+  PCP_ALLOWED_HOSTS Comma-separated hostspecs allowed via host parameter (optional)
+                    If not set, only target_host is allowed. Use '*' for any host.
 
 Examples:
   # Monitor localhost (default)

{pcp_mcp-0.1.0 → pcp_mcp-1.0.1}/src/pcp_mcp/client.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 import asyncio
 import sys
+from typing import TYPE_CHECKING
 
 if sys.version_info >= (3, 11):
     from typing import Self
@@ -12,6 +13,12 @@ else:
 
 import httpx
 
+if TYPE_CHECKING:
+    from collections.abc import Callable, Coroutine
+    from typing import Any
+
+    ProgressCallback = Callable[[float, float, str], Coroutine[Any, Any, None]]
+
 
 class PCPClient:
     """Async client for pmproxy REST API.
@@ -24,6 +31,7 @@ class PCPClient:
         target_host: Which pmcd host to connect to (passed as hostspec).
         auth: Optional HTTP basic auth tuple (username, password).
         timeout: Request timeout in seconds.
+        verify: TLS verification (True, False, or path to CA bundle).
     """
 
     def __init__(
@@ -32,12 +40,14 @@ class PCPClient:
         target_host: str = "localhost",
         auth: tuple[str, str] | None = None,
         timeout: float = 30.0,
+        verify: bool | str = True,
     ) -> None:
         """Initialize the PCP client."""
         self._base_url = base_url
         self._target_host = target_host
         self._auth = auth
         self._timeout = timeout
+        self._verify = verify
         self._client: httpx.AsyncClient | None = None
         self._context_id: int | None = None
 
@@ -47,6 +57,7 @@ class PCPClient:
             base_url=self._base_url,
             auth=self._auth,
             timeout=self._timeout,
+            verify=self._verify,
         )
         resp = await self._client.get(
             "/pmapi/context",
@@ -185,6 +196,7 @@ class PCPClient:
         metric_names: list[str],
         counter_metrics: set[str],
         sample_interval: float = 1.0,
+        progress_callback: ProgressCallback | None = None,
     ) -> dict[str, dict]:
         """Fetch metrics, calculating rates for counters.
 
@@ -196,15 +208,31 @@ class PCPClient:
             metric_names: List of PCP metric names to fetch.
             counter_metrics: Set of metric names that are counters.
             sample_interval: Seconds between samples for rate calculation.
+            progress_callback: Optional async callback for progress updates.
+                Called with (current, total, message) during long operations.
 
         Returns:
             Dict mapping metric name to {value, instances} where value/instances
             contain the rate (for counters) or instant value (for gauges).
         """
+        if progress_callback:
+            await progress_callback(0, 100, "Collecting first sample...")
+
         t1 = await self.fetch(metric_names)
+
+        if progress_callback:
+            await progress_callback(20, 100, f"Waiting {sample_interval}s for rate calculation...")
+
         await asyncio.sleep(sample_interval)
+
+        if progress_callback:
+            await progress_callback(70, 100, "Collecting second sample...")
+
         t2 = await self.fetch(metric_names)
 
+        if progress_callback:
+            await progress_callback(90, 100, "Computing rates...")
+
         ts1 = t1.get("timestamp", 0.0)
         ts2 = t2.get("timestamp", 0.0)
         if isinstance(ts1, dict):

pcp_mcp-1.0.1/src/pcp_mcp/config.py

@@ -0,0 +1,107 @@
+"""Configuration for the PCP MCP server."""
+
+from __future__ import annotations
+
+from pydantic import Field, computed_field
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class PCPMCPSettings(BaseSettings):
+    """Configuration for the PCP MCP server.
+
+    Attributes:
+        host: pmproxy host.
+        port: pmproxy port.
+        use_tls: Use HTTPS for pmproxy connection.
+        timeout: Request timeout in seconds.
+        target_host: Target pmcd host to monitor (can be remote hostname).
+        username: HTTP basic auth user.
+        password: HTTP basic auth password.
+    """
+
+    model_config = SettingsConfigDict(
+        env_file=".env",
+        env_prefix="PCP_",
+        extra="ignore",
+    )
+
+    host: str = Field(default="localhost", description="pmproxy host")
+    port: int = Field(default=44322, description="pmproxy port")
+    use_tls: bool = Field(default=False, description="Use HTTPS for pmproxy connection")
+    tls_verify: bool = Field(
+        default=True,
+        description="Verify TLS certificates when use_tls is enabled",
+    )
+    tls_ca_bundle: str | None = Field(
+        default=None,
+        description="Path to custom CA bundle for TLS verification",
+    )
+    timeout: float = Field(default=30.0, description="Request timeout in seconds")
+    target_host: str = Field(
+        default="localhost",
+        description="Target pmcd host to monitor (can be remote hostname)",
+    )
+    username: str | None = Field(default=None, description="HTTP basic auth user")
+    password: str | None = Field(default=None, description="HTTP basic auth password")
+    allowed_hosts: list[str] | None = Field(
+        default=None,
+        description=(
+            "Allowlist of hostspecs that can be queried via the host parameter. "
+            "If None, only the configured target_host is allowed (default). "
+            "Set to ['*'] to allow any host (use with caution)."
+        ),
+    )
+
+    @computed_field
+    @property
+    def base_url(self) -> str:
+        """URL for connecting to pmproxy."""
+        scheme = "https" if self.use_tls else "http"
+        return f"{scheme}://{self.host}:{self.port}"
+
+    @computed_field
+    @property
+    def auth(self) -> tuple[str, str] | None:
+        """Auth tuple for httpx, or None if no auth configured."""
+        if self.username and self.password:
+            return (self.username, self.password)
+        return None
+
+    @computed_field
+    @property
+    def verify(self) -> bool | str:
+        """TLS verification setting for httpx.
+
+        Returns:
+            False if verification disabled, path to CA bundle if specified,
+            or True for default system verification.
+        """
+        if not self.tls_verify:
+            return False
+        if self.tls_ca_bundle:
+            return self.tls_ca_bundle
+        return True
+
+    def is_host_allowed(self, host: str) -> bool:
+        """Check if a host is allowed by the allowlist.
+
+        Args:
+            host: The hostspec to validate.
+
+        Returns:
+            True if the host is allowed, False otherwise.
+        """
+        # Always allow the configured target_host
+        if host == self.target_host:
+            return True
+
+        # If no allowlist configured, only target_host is allowed
+        if self.allowed_hosts is None:
+            return False
+
+        # Wildcard allows everything
+        if "*" in self.allowed_hosts:
+            return True
+
+        # Check exact match in allowlist
+        return host in self.allowed_hosts

pcp_mcp-1.0.1/src/pcp_mcp/context.py

@@ -0,0 +1,104 @@
+"""Context helpers for safe lifespan context access."""
+
+from __future__ import annotations
+
+from collections.abc import AsyncIterator
+from contextlib import asynccontextmanager
+from typing import TYPE_CHECKING
+
+from fastmcp import Context
+from fastmcp.exceptions import ToolError
+
+from pcp_mcp.client import PCPClient
+
+if TYPE_CHECKING:
+    from pcp_mcp.config import PCPMCPSettings
+
+
+def _validate_context(ctx: Context) -> None:
+    """Validate context has lifespan_context available.
+
+    Args:
+        ctx: MCP context.
+
+    Raises:
+        ToolError: If context is not available.
+    """
+    if ctx.request_context is None or ctx.request_context.lifespan_context is None:
+        raise ToolError("Server context not available")
+
+
+def get_client(ctx: Context) -> PCPClient:
+    """Get PCPClient from context.
+
+    Args:
+        ctx: MCP context.
+
+    Returns:
+        The PCPClient instance.
+
+    Raises:
+        ToolError: If context is not available.
+    """
+    _validate_context(ctx)
+    assert ctx.request_context is not None
+    assert ctx.request_context.lifespan_context is not None
+    return ctx.request_context.lifespan_context["client"]
+
+
+def get_settings(ctx: Context) -> PCPMCPSettings:
+    """Get settings from context.
+
+    Args:
+        ctx: MCP context.
+
+    Returns:
+        The PCPMCPSettings instance.
+
+    Raises:
+        ToolError: If context is not available.
+    """
+    _validate_context(ctx)
+    assert ctx.request_context is not None
+    assert ctx.request_context.lifespan_context is not None
+    return ctx.request_context.lifespan_context["settings"]
+
+
+@asynccontextmanager
+async def get_client_for_host(ctx: Context, host: str | None = None) -> AsyncIterator[PCPClient]:
+    """Get a PCPClient for the specified host.
+
+    If host is None or matches the configured target_host, yields the existing
+    lifespan client. Otherwise, creates a new ad-hoc client for the specified
+    hostspec and cleans it up on exit.
+
+    Args:
+        ctx: MCP context.
+        host: Target pmcd hostspec to query. None uses the default.
+
+    Yields:
+        PCPClient connected to the specified host.
+
+    Raises:
+        ToolError: If context is not available, host is not allowed, or host is unreachable.
+    """
+    settings = get_settings(ctx)
+
+    if host is None or host == settings.target_host:
+        yield get_client(ctx)
+        return
+
+    if not settings.is_host_allowed(host):
+        raise ToolError(
+            f"Host '{host}' is not in the allowed hosts list. "
+            f"Configure PCP_ALLOWED_HOSTS to permit additional hosts."
+        )
+
+    async with PCPClient(
+        base_url=settings.base_url,
+        target_host=host,
+        auth=settings.auth,
+        timeout=settings.timeout,
+        verify=settings.verify,
+    ) as client:
+        yield client

pcp_mcp-1.0.1/src/pcp_mcp/icons.py

@@ -0,0 +1,31 @@
+"""Centralized icons and tags for MCP components."""
+
+from __future__ import annotations
+
+from mcp.types import Icon
+
+ICON_METRICS = Icon(src="data:,📊", mimeType="text/plain")
+ICON_SEARCH = Icon(src="data:,🔍", mimeType="text/plain")
+ICON_INFO = Icon(src="data:,📋", mimeType="text/plain")
+ICON_SYSTEM = Icon(src="data:,💻", mimeType="text/plain")
+ICON_PROCESS = Icon(src="data:,⚙️", mimeType="text/plain")
+ICON_HEALTH = Icon(src="data:,💚", mimeType="text/plain")
+ICON_CATALOG = Icon(src="data:,📚", mimeType="text/plain")
+ICON_NAMESPACE = Icon(src="data:,🗂️", mimeType="text/plain")
+ICON_DIAGNOSE = Icon(src="data:,🔬", mimeType="text/plain")
+ICON_CPU = Icon(src="data:,🖥️", mimeType="text/plain")
+ICON_MEMORY = Icon(src="data:,🧠", mimeType="text/plain")
+ICON_DISK = Icon(src="data:,💾", mimeType="text/plain")
+ICON_NETWORK = Icon(src="data:,🌐", mimeType="text/plain")
+
+TAGS_METRICS = {"metrics", "pcp"}
+TAGS_SYSTEM = {"system", "monitoring", "performance"}
+TAGS_PROCESS = {"processes", "monitoring"}
+TAGS_HEALTH = {"health", "status", "summary"}
+TAGS_CATALOG = {"catalog", "reference", "documentation"}
+TAGS_DISCOVERY = {"discovery", "namespace", "exploration"}
+TAGS_CPU = {"cpu", "troubleshooting", "performance"}
+TAGS_MEMORY = {"memory", "troubleshooting", "performance"}
+TAGS_DISK = {"disk", "io", "troubleshooting", "performance"}
+TAGS_NETWORK = {"network", "troubleshooting", "performance"}
+TAGS_DIAGNOSE = {"diagnosis", "troubleshooting", "workflow"}