sysmcp

io.github.arunmm8335由 GitHub 帳號 arunmm8335 發布v0.5.0更新於 Oct 24, 2026

Live Linux host signal (CPU, memory, processes, network, optional eBPF) for MCP clients.

已驗證STDIO僅桌面雲端與基礎設施安全與監控

概覽

AI 產生的概覽

一個本機 MCP 伺服器，向 Cursor、Claude 等 AI 助理提供 Linux 主機的即時訊號：CPU、記憶體、行程與網路。

可以做什麼
讀取 CPU、記憶體、負載平均值與各網卡的網路速率，可輪詢輕量快照供自動重新整理，或取得包含熱門行程與監聽埠的完整主機儀表板快照。依取樣期間的 CPU 使用率列出熱門行程，並依 CPU 使用率列出熱門 cgroup。檢視 IPv4 與 IPv6 的 TCP/UDP 連線，支援僅監聽、協定、位址族、狀態、本機埠、所屬 PID 與列數上限等篩選。在授予對應能力後，可選擇回報 eBPF 狀態、fork 與排程活動以及核心封包速率。
適用情境
適合讓助理診斷或監控其所在的 Linux 機器：查看負載、找出佔用 CPU 高的行程、確認哪些埠在監聽，或在除錯時觀察網路吞吐量。
執行需求
以本機行程執行於 Linux（amd64 或 arm64），可透過發行版二進位檔安裝、以 Go 從原始碼建置，或在 MCP 用戶端設定中以絕對路徑指定。預設資料來自 /proc，不需 root。選用的 eBPF 工具需要為二進位檔授予 CAP_BPF 與 CAP_PERFMON，並重新啟動服務。
安裝前請注意
伺服器會讀取行程清單、網路連線等即時主機資料，可能包含執行中服務的敏感資訊，請留意助理宿主後續如何轉送這些資料。授予 CAP_BPF 與 CAP_PERFMON 會讓該二進位檔取得核心層級監控的高權限，僅在信任該建置時授予。它僅做唯讀監控，不會變更主機狀態。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 sysmcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

sysmcp

MCP server that exposes live host signal — CPU, memory, processes, network — to Cursor / Claude. Default path is /proc (no root). Optional eBPF tools activate when CAP_BPF / CAP_PERFMON is available.

Repo: https://github.com/arunmm8335/sysmcp · Version: 0.5.0

Tools

ToolWhat it returns
host_dashboardFull snapshot (CPU, mem, top procs, listeners, eBPF)
poll_host_statsLightweight CPU/mem/process snapshot for auto-refresh
system_statsCPU %, memory %, load averages, NIC rx/tx B/s
top_processesTop PIDs by CPU % over a sample window, plus skipped_count
network_connectionsIPv4+IPv6 TCP/UDP; filters + resolve_pid; row limit (default 200)
cgroup_cpuTop cgroups by CPU % (cgroup v2 cpu.stat)
iface_ratesPer-interface byte/packet rates (/proc/net/dev)
ebpf_statusWhether eBPF works; includes how_to_enable when not
ebpf_activityFork + sched_switch rates via eBPF, or available: false
ebpf_trafficKernel RX/TX packet rates (netif_receive_skb / net_dev_xmit)

True per-connection byte counters need sock-level eBPF; iface_rates + ebpf_traffic are the practical deeper network signal today.

Browser dashboard (HTTP)

bash
go build -o sysmcp ./cmd/sysmcp./sysmcp serve# open http://127.0.0.1:8787/

Optional: ./sysmcp serve -addr 127.0.0.1:9000

APIs: /api/dashboard, /api/poll (JSON).

Interactive views in Cursor

Ask “Open the host dashboard” / “Refresh the host dashboard”. The agent calls host_dashboard and opens a Cursor Canvas beside the chat.

MCP Apps resource ui://sysmcp/dashboard remains for hosts that render Apps iframes. Cursor often uses Canvas + JSON instead.

network_connections filters

ArgEffect
listen_onlyTCP LISTEN + unbound UDP
protocoltcp / udp
familyipv4 / ipv6
statee.g. ESTABLISHED, LISTEN
local_portfilter by local port
pidowning PID (implies resolve_pid)
limitmax rows (default 200, max 1000); truncated in result

Install

Release binaries (linux amd64 / arm64) ship on each v* tag:

https://github.com/arunmm8335/sysmcp/releases

bash
# example amd64curl -fsSL -o sysmcp.tgz \  https://github.com/arunmm8335/sysmcp/releases/download/v0.5.0/sysmcp_0.5.0_linux_amd64.tar.gztar -xzf sysmcp.tgz

Or from source:

bash
go install github.com/arunmm8335/sysmcp/cmd/sysmcp@latest# orgit clone https://github.com/arunmm8335/sysmcp.gitcd sysmcpgo build -o sysmcp ./cmd/sysmcp

MCP Registry (one-click)

Namespace: io.github.arunmm8335/sysmcp. Tag releases build .mcpb assets and attempt an OIDC publish via mcp-publisher. To publish manually after a release (recommended if OIDC is not set up):

bash
# fill fileSha256 in server.json from the release *.mcpb.sha256 files, then:curl -fsSL -o mcp-publisher.tgz \  https://github.com/modelcontextprotocol/registry/releases/download/v1.8.0/mcp-publisher_linux_amd64.tar.gztar -xzf mcp-publisher.tgz mcp-publisher./mcp-publisher login github./mcp-publisher publish ./server.json

See https://modelcontextprotocol.io/registry/quickstart

Cursor / Claude MCP config

json
{  "mcpServers": {    "sysmcp": {      "command": "/absolute/path/to/sysmcp"    }  }}

Enable eBPF (optional)

bash
go build -o sysmcp ./cmd/sysmcp./scripts/grant-caps.sh ./sysmcp# sets: cap_bpf,cap_perfmon+ep

Restart the MCP server after granting caps. Without caps, eBPF tools return available: false — /proc tools still work.

Demo

bash
go test ./... -count=1go build -o sysmcp ./cmd/sysmcpgo run ./scripts/smoke.go ./sysmcp./sysmcp serve   # then open http://127.0.0.1:8787/

License

MIT

來源：README.md，提交 8868a43

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.5.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分