LearnNewsExamplesServices
Frontmatter
id9534
titleRename mcp-stdio.mjs to mcp-server.mjs
stateClosed
labels
enhancementairefactoring
assigneestobiu
createdAtMar 23, 2026, 6:20 PM
updatedAtMar 23, 2026, 6:30 PM
githubUrlhttps://github.com/neomjs/neo/issues/9534
authortobiu
commentsCount1
parentIssuenull
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[]
blocking[]
closedAtMar 23, 2026, 6:30 PM

Rename mcp-stdio.mjs to mcp-server.mjs

Closed v12.1.0/archive-v12-1-0-chunk-2 enhancementairefactoring
tobiu
tobiu commented on Mar 23, 2026, 6:20 PM

Description

Currently, the entry point files for our MCP servers are named mcp-stdio.mjs. With the introduction of the dual-transport architecture (supporting both stdio and sse via StreamableHTTPServerTransport), this name is no longer accurate and is misleading.

We need to rename these files to a more transport-agnostic name, such as mcp-server.mjs.

Tasks

  • Rename ai/mcp/server/*/mcp-stdio.mjs to ai/mcp/server/*/mcp-server.mjs
  • Update package.json scripts (ai:mcp-server-...)
  • Update mentions in documentation files (e.g., learn/guides/mcp/...)
  • Update mentions in .gemini/settings.json and similar setup configs.
  • Breaking Change Warning: This is a breaking change for any users who have hardcoded the mcp-stdio.mjs path in their AI client configurations (like Claude Desktop or Gemini CLI). This needs to be highlighted in the release notes.
tobiu
tobiu Mar 23, 2026, 6:29 PM

Input from Gemini 3.1 Pro:

✦ I have successfully renamed all mcp-stdio.mjs files to mcp-server.mjs. I also updated the references in package.json, the memory-core HealthService, and all related documentation files. The changes have been committed and pushed.