anomalyco / anomalyco/opencode

Local MCP disconnect leaves descendant processes running

Open
#46,253 0 comments 0 reactions 1 assignee View on GitHub

@rekram1-node is already working on this.

Since Aug 30, 2026.

Dominant language
TypeScript
Stars
209k
Forks
27.5k
PR merge metrics
PR metrics pending

Description

Description

A local stdio MCP can spawn a wrapper process tree (npm exec, uvx, shell wrappers). Explicit disconnect and dynamic replacement call client.close(), which terminates the direct transport process but leaves its descendants running.

Full instance teardown already enumerates and terminates descendants, so cleanup behavior differs by lifecycle path. I reproduced this with a real stdio MCP fixture: before the fix, the parent exits and the child remains alive past the assertion deadline.

Expected: every MCP client ownership exit terminates the same full local process tree.

Related but distinct from #46035: that report currently shows complete MCP sets with live launchers, while this issue covers descendants left after teardown is invoked. Also related to the memory tracking thread #20695.

Plugins

None

OpenCode version

Current dev at dc4449df0d

Steps to reproduce
  1. Configure a local stdio MCP whose launcher spawns a long-lived child process.
  2. Connect it, then call MCP disconnect or replace the server under the same name.
  3. Observe that the launcher exits while the child process remains alive.
Screenshot and/or share link

N/A; covered by a deterministic PID-based regression test.

Operating System

Linux x64

Terminal

N/A (automated integration test)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.