关于 What's Running
What's Running 是面向多 Agent 工作环境的 MCP 服务,供需要核实本机实时进程和服务状态的开发者使用。它直接读取操作系统信息,展示 Agent 会话、监听端口、守护进程和系统负载,而非依赖文档或会话记录。
主要功能
- 01查看 Agent 进程及工作目录
- 02列出 TCP 监听端口及所属进程
- 03检查已加载的守护进程
- 04查看负载、运行时间和磁盘空间
- 05提供只读的实时系统快照
适用场景
- 01核实开发服务器是否仍在运行
- 02查找终端连接或孤立的 Agent 会话
- 03确认端口由哪个进程占用
- 04检查用户级守护进程和系统负载
MCP 相关
作为 MCP 服务,它向客户端提供工具,以查询本机实时 Agent 会话、TCP 监听端口、已加载守护进程和系统统计信息。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
whats-running-mcp
为 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_PATTERNS | claude,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
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。