pcp-mcp 1.0.1__py3-none-any.whl → 1.0.3__py3-none-any.whl

pcp_mcp/models.py

@@ -33,6 +33,18 @@ class MetricSearchResult(BaseModel):
     help_text: str | None = Field(default=None, description="Brief description")
 
 
+class MetricValueList(BaseModel):
+    """Container for a list of metric values (MCP requires object return types)."""
+
+    metrics: list[MetricValue] = Field(description="List of metric values")
+
+
+class MetricSearchResultList(BaseModel):
+    """Container for metric search results (MCP requires object return types)."""
+
+    results: list[MetricSearchResult] = Field(description="List of matching metrics")
+
+
 class InstancedMetric(BaseModel):
     """Metric with per-instance values (e.g., per-CPU, per-disk)."""
 

pcp_mcp/tools/metrics.py

@@ -4,7 +4,7 @@ from typing import TYPE_CHECKING, Annotated, Optional
 
 from fastmcp import Context
 from mcp.types import ToolAnnotations
-from pydantic import Field, TypeAdapter
+from pydantic import Field
 
 from pcp_mcp.context import get_client_for_host
 from pcp_mcp.icons import (
@@ -14,15 +14,19 @@ from pcp_mcp.icons import (
     TAGS_DISCOVERY,
     TAGS_METRICS,
 )
-from pcp_mcp.models import MetricInfo, MetricSearchResult, MetricValue
+from pcp_mcp.models import (
+    MetricInfo,
+    MetricSearchResult,
+    MetricSearchResultList,
+    MetricValue,
+    MetricValueList,
+)
 from pcp_mcp.utils.extractors import extract_help_text, format_units
 
 if TYPE_CHECKING:
     from fastmcp import FastMCP
 
 TOOL_ANNOTATIONS = ToolAnnotations(readOnlyHint=True, openWorldHint=True)
-METRIC_VALUE_LIST_SCHEMA = TypeAdapter(list[MetricValue]).json_schema()
-METRIC_SEARCH_LIST_SCHEMA = TypeAdapter(list[MetricSearchResult]).json_schema()
 
 
 def register_metrics_tools(mcp: "FastMCP") -> None:
@@ -30,7 +34,6 @@ def register_metrics_tools(mcp: "FastMCP") -> None:
 
     @mcp.tool(
         annotations=TOOL_ANNOTATIONS,
-        output_schema=METRIC_VALUE_LIST_SCHEMA,
         icons=[ICON_METRICS],
         tags=TAGS_METRICS,
     )
@@ -44,7 +47,7 @@ def register_metrics_tools(mcp: "FastMCP") -> None:
             Optional[str],
             Field(description="Target pmcd host to query (default: server's configured target)"),
         ] = None,
-    ) -> list[MetricValue]:
+    ) -> MetricValueList:
         """Fetch current values for specific PCP metrics.
 
         Returns the current value for each requested metric. For metrics with
@@ -88,11 +91,10 @@ def register_metrics_tools(mcp: "FastMCP") -> None:
                         )
                     )
 
-            return results
+            return MetricValueList(metrics=results)
 
     @mcp.tool(
         annotations=TOOL_ANNOTATIONS,
-        output_schema=METRIC_SEARCH_LIST_SCHEMA,
         icons=[ICON_SEARCH],
         tags=TAGS_METRICS | TAGS_DISCOVERY,
     )
@@ -106,7 +108,7 @@ def register_metrics_tools(mcp: "FastMCP") -> None:
             Optional[str],
             Field(description="Target pmcd host to query (default: server's configured target)"),
         ] = None,
-    ) -> list[MetricSearchResult]:
+    ) -> MetricSearchResultList:
         """Find PCP metrics matching a name pattern.
 
         Use this to discover available metrics before querying them.
@@ -127,13 +129,14 @@ def register_metrics_tools(mcp: "FastMCP") -> None:
             except Exception as e:
                 raise handle_pcp_error(e, "searching metrics") from e
 
-            return [
+            results = [
                 MetricSearchResult(
                     name=m.get("name", ""),
                     help_text=extract_help_text(m),
                 )
                 for m in metrics
             ]
+            return MetricSearchResultList(results=results)
 
     @mcp.tool(
         annotations=TOOL_ANNOTATIONS,

pcp_mcp/tools/system.py

@@ -1,7 +1,5 @@
 """System health tools for clumped metric queries."""
 
-from __future__ import annotations
-
 from datetime import datetime, timezone
 from typing import TYPE_CHECKING, Annotated, Literal, Optional
 
@@ -149,7 +147,7 @@ async def _fetch_system_snapshot(
         return snapshot
 
 
-def register_system_tools(mcp: FastMCP) -> None:
+def register_system_tools(mcp: "FastMCP") -> None:
     """Register system health tools with the MCP server."""
 
     @mcp.tool(

{pcp_mcp-1.0.1.dist-info → pcp_mcp-1.0.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pcp-mcp
-Version: 1.0.1
+Version: 1.0.3
 Summary: MCP server for Performance Co-Pilot
 Keywords: mcp,pcp,performance-co-pilot,monitoring,model-context-protocol
 Author: Major Hayden
@@ -41,7 +41,22 @@ Query system performance metrics via the Model Context Protocol - CPU, memory, d
 [![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
+## 🚀 Quick Start (No Install)
+
+Run immediately with [uvx](https://docs.astral.sh/uv/) — no installation required:
+
+```bash
+uvx pcp-mcp
+```
+
+Or install as a persistent global tool:
+
+```bash
+uvx tool install pcp-mcp
+pcp-mcp
+```
+
+## 📦 Installation
 
 ```bash
 pip install pcp-mcp
@@ -126,7 +141,8 @@ Add to `~/.config/claude/claude_desktop_config.json`:
 {
   "mcpServers": {
     "pcp": {
-      "command": "pcp-mcp"
+      "command": "uvx",
+      "args": ["pcp-mcp"]
     }
   }
 }
@@ -138,13 +154,15 @@ For remote monitoring:
 {
   "mcpServers": {
     "pcp": {
-      "command": "pcp-mcp",
-      "args": ["--target-host", "webserver1.example.com"]
+      "command": "uvx",
+      "args": ["pcp-mcp", "--target-host", "webserver1.example.com"]
     }
   }
 }
 ```
 
+> 💡 Using `uvx` means you don't need pcp-mcp installed — it runs directly from PyPI.
+
 ## 🛠️ Available Tools
 
 ### System Monitoring

{pcp_mcp-1.0.1.dist-info → pcp_mcp-1.0.3.dist-info}/RECORD

@@ -6,7 +6,7 @@ pcp_mcp/context.py,sha256=5M6l72phsijPr96PXpZDm1rd_Uvo7mY_LuiLdeiW2SE,2801
 pcp_mcp/errors.py,sha256=sIes9OSNdYQeOmwjFknhfXXjBjOOzXmc94bbB-4b_tg,1598
 pcp_mcp/icons.py,sha256=ZTMU4iDR0369NPOsaAyDhu-MngtdkbDY_QZbA6BjwN0,1497
 pcp_mcp/middleware.py,sha256=oUSdaCHSy1gVkKyeC2J8ASfhJep-3KvY8GFYRFWUvJ0,2387
-pcp_mcp/models.py,sha256=ugU3a-4PY5cVstxt6XAHGqBqXUt95HVYLq7z7sQDkTA,6835
+pcp_mcp/models.py,sha256=A7gJci-Gwzctjc_iEnQrGrJ2xq-CaBuemNiLIeujPk4,7244
 pcp_mcp/prompts/__init__.py,sha256=x3QDidJFt2CeLmFZWGLs673m9L9NUi2IC4Me5A9nxw4,12586
 pcp_mcp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pcp_mcp/resources/__init__.py,sha256=55Mm2ZCuyyQWWql9N8cLk6ld1pNj3Ezc416jgFX35dU,541
@@ -15,12 +15,12 @@ pcp_mcp/resources/health.py,sha256=cHnH2aRF4gdeo0AVUDi_qWqHocDSULhlsGpnkS-qobE,3
 pcp_mcp/server.py,sha256=N_XknbUCoURd7JQsNO8Tl7i9sdQZetTTE5LFsRjZozs,5030
 pcp_mcp/tools/AGENTS.md,sha256=1yt_W-TYlGA0aWJYCM7D0i2D4899E6_kIhyoqP1np-g,1963
 pcp_mcp/tools/__init__.py,sha256=sXhOqqnUwzSf16QU6eS79LMvXJcv7jqSXQlrpQG4UV0,505
-pcp_mcp/tools/metrics.py,sha256=r-kiAAFaIZue1FEqQuSHdvxHrXnSYhY73oru2HlSOGI,6834
-pcp_mcp/tools/system.py,sha256=g1f5j1qztUNW_4SL1pwFufZ5ZxphAn2sC6Zt98MApLk,16845
+pcp_mcp/tools/metrics.py,sha256=x0HrO_EQMPVM_IE-nC2aIYFqUys9BX15gYyLDMQkEnA,6721
+pcp_mcp/tools/system.py,sha256=X-ubTv-8Mhirmve9iFxwo1WLHb_lQ5akmbJ4OGLWRqI,16811
 pcp_mcp/utils/__init__.py,sha256=tTbcqrCV9pBBm7N3MwEI37Lc0JM1CVbw_etw36ejRWc,884
 pcp_mcp/utils/builders.py,sha256=n13Ou6cb1-YToG-M31J8_jWajq8ioJx6tJTKnqaQiio,10293
 pcp_mcp/utils/extractors.py,sha256=fy6aCI23JuGt73oIDxwPW_K4B0fJkFCF1VxYkBst0Y4,2279
-pcp_mcp-1.0.1.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
-pcp_mcp-1.0.1.dist-info/entry_points.txt,sha256=PhVo92EGoS05yEpHVRyKEsxKya_bWlPLodp-g4tr2Rg,42
-pcp_mcp-1.0.1.dist-info/METADATA,sha256=1b5nl2lT2GjZJRBJH8bkAAV6H8RPo26-F_uSdF8iyJo,6671
-pcp_mcp-1.0.1.dist-info/RECORD,,
+pcp_mcp-1.0.3.dist-info/WHEEL,sha256=XV0cjMrO7zXhVAIyyc8aFf1VjZ33Fen4IiJk5zFlC3g,80
+pcp_mcp-1.0.3.dist-info/entry_points.txt,sha256=PhVo92EGoS05yEpHVRyKEsxKya_bWlPLodp-g4tr2Rg,42
+pcp_mcp-1.0.3.dist-info/METADATA,sha256=VjDhKh4Dj2RFptMvtXhsVbtJ9PUJiu_ZWx9xw6rVWtU,7024
+pcp_mcp-1.0.3.dist-info/RECORD,,