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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pcp-mcp
-Version: 1.0.1
+Version: 1.0.2
 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 → pcp_mcp-1.0.2}/README.md

@@ -12,7 +12,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
@@ -97,7 +112,8 @@ Add to `~/.config/claude/claude_desktop_config.json`:
 {
   "mcpServers": {
     "pcp": {
-      "command": "pcp-mcp"
+      "command": "uvx",
+      "args": ["pcp-mcp"]
     }
   }
 }
@@ -109,13 +125,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 → pcp_mcp-1.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pcp-mcp"
-version = "1.0.1"
+version = "1.0.2"
 description = "MCP server for Performance Co-Pilot"
 readme = "README.md"
 license = "MIT"

{pcp_mcp-1.0.1 → pcp_mcp-1.0.2}/src/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-1.0.1 → pcp_mcp-1.0.2}/src/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,