Pcp MCP

🚀 pcp-mcp

pcp-mcp 是一個用於 性能協同監控平臺 (Performance Co-Pilot, PCP) 指標的 MCP 服務器。它允許用戶通過模型上下文協議查詢系統性能指標，涵蓋 CPU、內存、磁盤 I/O、網絡、進程等多個方面。

📖 完整文檔 | 🚀 快速開始

🚀 快速開始（無需安裝）

使用 uvx 可立即運行，無需安裝：

uvx pcp-mcp

或者將其作為全局工具持久安裝：

uvx tool install pcp-mcp
pcp-mcp

📦 安裝指南

使用 pip 安裝：

pip install pcp-mcp

或者使用 uv 安裝：

uv add pcp-mcp

📋 安裝要求

• Python：3.10 及以上版本
• PCP：需運行 pmcd 和 pmproxy 的性能協同監控平臺

# Fedora/RHEL/CentOS
sudo dnf install pcp
sudo systemctl enable --now pmcd pmproxy

# Ubuntu/Debian
sudo apt install pcp
sudo systemctl enable --now pmcd pmproxy

⚙️ 配置說明

通過環境變量進行配置：

💻 使用示例

監控本地主機（默認）

pcp-mcp

監控遠程主機

PCP_TARGET_HOST=webserver1.example.com pcp-mcp

或者使用 CLI 標誌：

pcp-mcp --target-host webserver1.example.com

連接到遠程 pmproxy

PCP_HOST=metrics.example.com pcp-mcp

使用 SSE 傳輸

pcp-mcp --transport sse

🔌 MCP 客戶端配置

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "pcp": {
      "command": "uvx",
      "args": ["pcp-mcp"]
    }
  }
}

用於遠程監控：

{
  "mcpServers": {
    "pcp": {
      "command": "uvx",
      "args": ["pcp-mcp", "--target-host", "webserver1.example.com"]
    }
  }
}

💡 使用 uvx 意味著你無需安裝 pcp-mcp，它可以直接從 PyPI 運行。

🛠️ 可用工具

系統監控

• get_system_snapshot - 獲取系統的即時概況（CPU、內存、磁盤、網絡、負載）
• get_process_top - 按 CPU、內存或 I/O 使用情況列出頂級進程
• query_metrics - 獲取特定 PCP 指標的當前值
• search_metrics - 按名稱模式發現可用指標
• describe_metric - 獲取指標的詳細元數據

查詢示例

"當前 CPU 使用率是多少？"
→ 使用 get_system_snapshot

"顯示按內存使用情況排名前 10 的進程"
→ 使用 get_process_top(sort_by="memory", limit=10)

"網絡流量有哪些可用指標？"
→ 使用 search_metrics(pattern="network")

"獲取 kernel.all.load 的詳細信息"
→ 使用 describe_metric(name="kernel.all.load")

💡 使用場景

性能故障排除

向 Claude 詢問：

• "分析當前系統性能並找出瓶頸"
• "為什麼我的磁盤 I/O 這麼高？"
• "哪些進程佔用了最多的 CPU？"

系統監控

• "對生產服務器進行健康檢查"
• "比較過去一分鐘的 CPU 使用率"
• "監控 eth0 上的網絡流量"

容量規劃

• "內存利用率趨勢如何？"
• "顯示所有文件系統的磁盤使用情況"
• "分析進程資源消耗模式"

🏗️ 架構說明

┌─────────┐         ┌─────────┐          ┌─────────┐         ┌─────────┐
│   LLM   │ ◄─MCP─► │ pcp-mcp │ ◄─HTTP─► │ pmproxy │ ◄─────► │  pmcd   │
└─────────┘         └─────────┘          └─────────┘         └─────────┘
                                         (REST API)          (metrics)

• pcp-mcp：通過 MCP 工具公開 PCP 指標的 FastMCP 服務器
• pmproxy：PCP 的 REST API 服務器（默認運行在端口 44322）
• pmcd：PCP 指標收集守護進程
• 遠程監控：設置 PCP_TARGET_HOST 可通過 pmproxy 查詢不同的 pmcd 實例

🔧 開發指南

# 安裝依賴
uv sync --dev

# 運行所有檢查
make check

# 單獨的命令
make lint       # ruff 檢查
make format     # ruff 格式化
make typecheck  # ty 類型檢查
make test       # 帶覆蓋率的 pytest 測試

📚 詳細文檔

完整文檔請訪問 https://major.github.io/pcp-mcp

📄 許可證

本項目採用 MIT 許可證。