mcpField
W
What's Running

What's Running

本地服务
shifttheculture.media开发工具04 周前更新
代码仓库访问官网

关于 What's Running

What's Running 是面向需要实时机器状态的 Agent 的只读 MCP 服务，数据直接读取自操作系统，而非缓存报告。它可查看 Agent 进程、监听端口、守护进程和基本系统统计。

主要功能

  1. 01查看实时 Agent 进程
  2. 02查看 TCP 监听端口及所属进程
  3. 03列出已加载的守护进程
  4. 04查看负载、运行时间和磁盘空间
  5. 05只读且有执行时限的系统查询

适用场景

  1. 01在会话开始时检查机器状态
  2. 02确认服务是否正在监听
  3. 03查找分离或孤立的 Agent 会话
  4. 04检查用户服务和系统负载

MCP 相关

向 MCP 客户端提供五个只读工具，用于查询本机 Agent 会话、端口、守护进程和系统统计。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "stcmain-whats-running": {
      "command": "npx",
      "args": [
        "-y",
        "whats-running-mcp"
      ],
      "env": {
        "WR_AGENT_PATTERNS": "<WR_AGENT_PATTERNS>"
      }
    }
  }
}
启动命令npx -y whats-running-mcp
需要配置的环境变量
WR_AGENT_PATTERNSComma-separated process-name substrings treated as agent sessions. Default: claude,codex,aider,cursor-agent,copilot,goose

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmwhats-running-mcp0.1.6

工具

5

收录的工具列表 · 更新于 2 周前

参数类型必填说明
include_detachedboolean否也列出没有终端的后台/孤立 Agent 进程（默认 true）

详细介绍

whats-running-mcp

npm license Glama

为 Agent 集群提供真实依据。 一个 MCP 服务，可告知 AI Agent 机器上实际运行着什么——实时 Agent 会话、正在监听的 TCP 端口、已加载的守护进程、系统负载——直接从操作系统（ps / lsof / launchctl / df）读取，而非从文档、对话记录或记忆文件中获取。

为什么要用

如果你运行过多个编码 Agent 会话（Claude Code、Codex、Aider……），一定遇到过这种情况：Agent 对几周前就已停止运行的服务进行“健康检查”，或者因为旧对话记录中的说法，就信誓旦旦地报告某个守护进程仍在运行。模型记忆只是一个无法失效的缓存。操作系统才是事实来源。

这个服务最初是一个名为 whats-running 的 shell 脚本，是我在自己的 Claude Code 会话集群反复将过时状态报告为当前状态后编写的。将它封装为 MCP 服务后，每个会话都能自动以相同方式获取真实状态。

工具

工具功能
whats_running一次调用获取完整快照——适合在会话开始时使用
agent_sessions哪些 Agent 进程正在运行？区分附加到终端的进程与脱离终端／孤立进程，并提供 pid、运行时长和工作目录
listening_ports服务 X 是否确实在运行？列出所有 TCP LISTEN 套接字及其所属进程
daemons加载了哪些常驻服务？在 macOS（非 Apple 系统）上使用 launchctl，在 Linux 上使用 systemd 用户服务，并可按标签筛选
system_stats平均负载、运行时长、根磁盘可用空间

安装

Claude Desktop（一键安装，无需终端）： 从 Releases 下载最新的 whats-running-mcp-<version>.dxt，然后用 Claude Desktop 打开（双击，或前往 Settings → Extensions → Install Extension…）。服务及其依赖项已打包在其中——无需 npm，也无需安装 Node。

注册到 Claude Code（每个会话均可使用）：

claude mcp add --scope user whats-running -- npx -y whats-running-mcp

或在任意 MCP 客户端配置中：

{
  "mcpServers": {
    "whats-running": {
      "command": "npx",
      "args": ["-y", "whats-running-mcp"]
    }
  }
}
从源代码安装 
git clone https://github.com/stcmain/whats-running-mcp.git
cd whats-running-mcp
npm install && npm run build
# then point your client at node /path/to/whats-running-mcp/dist/index.js

已在 npm 上发布为 whats-running-mcp，并在 MCP Registry 中以 io.github.stcmain/whats-running-mcp 发布。

配置

环境变量默认值用途
WR_AGENT_PATTERNSclaude,codex,aider,cursor-agent,copilot,goose以逗号分隔的子字符串，用于在 agent_sessions 中将进程标记为“Agent”

设计说明

  • 从设计上确保只读。 每条命令都通过 execFile 执行固定二进制文件和固定标志——不使用 shell，也绝不执行任何源自模型输入的内容。模型唯一可控的输入是布尔值和在进程内应用的子字符串筛选条件。
  • 目标就是披露本地信息。 模型可以看到你自己的机器上的进程名称、pid、工作目录和端口。不要将此服务连接到不可信的客户端。
  • 尽力而为，绝不阻塞。 命令在 10s 后超时；如果失败，则返回空结果，而不会导致整个快照报错。

平台支持：优先支持 macOS（我日常使用的系统），Linux 尽力支持（以 systemd --user 代替 launchctl）。

相关免费工具

理念相同——只读、MIT 许可、不收集遥测数据，但关注不同的盲点：

  • whats-loaded-mcp — 在会话开始 之前，有哪些内容正在消耗 Agent 的上下文：按 token 成本排序的技能描述、重复安装的技能、CLAUDE.md/AGENTS.md 的大小（包括导入文件带来的内容）。npx -y whats-loaded-mcp
  • whats-inherited-mcp — 在你运行检出内容 之前，它会告诉 Agent 要做什么：指令文件、配置为自动运行的命令、声明的 MCP 服务、随附的技能。仓库中的字符串会被标记为数据，而非指令。npx -y whats-inherited-mcp
  • whats-allowed-mcp — Agent 无需征求你同意就能 执行哪些操作：所有参与提供权限规则的设置文件、哪个文件优先、哪些操作会在无人干预的情况下运行，以及客户端接受后又忽略的规则。npx -y whats-allowed-mcp

关于作者

由 Shift The Culture 构建——我们用 AI Agent 运营一家一人公司，并发布自己需要的工具。此服务免费且采用 MIT 许可，没有任何附加条件。

此服务是更大型多 Agent 配置中的免费独立部分。其余工具需付费：

  • Agent Fleet Ops Kit ($29) — 在一台机器上运行三到四个 Agent 时的其他故障模式：两个会话同时编辑同一个检出内容、无人负责的开发服务器（导致 Agent 测试的应用与它编辑的应用不同），以及崩溃会话遗留的 MCP 服务占用端口和内存数周。 更喜欢 PayPal？也可在 Payhip 购买同一套工具。

  • Agent Reliability Kit ($29) — 一个 Stop hook 和两个 CLI；当 Agent 声称对某个仓库、URL 或构建“已完成”，但实际上从未检查过时，它们会阻止该轮继续。

    更喜欢 PayPal？也可在 Payhip 购买同一套工具。

上面的服务无论如何都会保持免费并采用 MIT 许可——它不包含任何升级推销，不收集遥测数据，也不依赖付费工具包。

赞助商

此服务采用 MIT 许可，并将始终如此。它没有专业版，不收集遥测数据， 免费版本也不会隐藏任何功能。赞助能为维护工作提供资金， 且不会改变以上任何一点。

目前还没有赞助商——首个赞助席位开放中。 企业赞助商的名称或 Logo 将展示在本节、两个姊妹服务以及赞助商页面中。 赞助档位、具体展示内容以及明确不包含的权益： https://shifttheculture.media/sponsor

个人赞助：https://paypal.me/ShiftTheCultureLLC — 金额不限，无额外福利，也无档位。

许可证

MIT © Zachary Pampu

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。