mcpField
W
What's Running

What's Running

本地服务
github.com/stcmain开发工具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查找终端连接或孤立的 Agent 会话
  3. 03确认端口由哪个进程占用
  4. 04检查用户级守护进程和系统负载

MCP 相关

作为 MCP 服务,它向客户端提供工具,以查询本机实时 Agent 会话、TCP 监听端口、已加载守护进程和系统统计信息。

配置

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

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

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 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。