Skip to content

fix: accept mcpServers as alias for mcp in config #621

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
VJ-yadav wants to merge 5 commits into from
Closed

fix: accept mcpServers as alias for mcp in config #621

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
c292be1
fix: accept mcpServers as alias for mcp in config
VJ-yadav Apr 3, 2026
1552e99
Merge branch 'main' into fix/mcp-servers-config-alias
anandgupta42 Apr 4, 2026
b1730d9
Merge branch 'main' into fix/mcp-servers-config-alias
anandgupta42 Apr 5, 2026
3c3c027
Merge branch 'main' into fix/mcp-servers-config-alias
anandgupta42 Apr 5, 2026
63e0986
Merge branch 'main' into fix/mcp-servers-config-alias
anandgupta42 Apr 5, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions packages/opencode/src/config/config.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1433,6 +1433,12 @@ export namespace Config {
const normalized = (() => {
if (!data || typeof data !== "object" || Array.isArray(data)) return data
const copy = { ...(data as Record<string, unknown>) }
// Alias mcpServers → mcp (Claude Code / Copilot format compatibility)
if ("mcpServers" in copy && !("mcp" in copy)) {
copy.mcp = copy.mcpServers
delete copy.mcpServers
log.info("aliased mcpServers to mcp in config", { path: source })
}
Comment on lines +1436 to +1441
Copy link
Copy Markdown

@coderabbitai coderabbitai bot Apr 5, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion | 🟠 Major

Remove duplicate normalization logic.

This code duplicates the mcpServers → mcp aliasing already handled by normalizeMcpConfig() (lines 1375-1383), which is called immediately after at line 1450. Since this code executes first, the normalization logic inside normalizeMcpConfig becomes unreachable for the top-level key, creating dead code and maintenance confusion.

The normalizeMcpConfig function is more comprehensive—it handles both the top-level key aliasing and individual server entry normalization. Consolidating all MCP normalization in one place improves maintainability and follows the DRY principle.

♻️ Proposed fix: Remove duplicate normalization 
  const normalized = (() => {
    if (!data || typeof data !== "object" || Array.isArray(data)) return data
    const copy = { ...(data as Record<string, unknown>) }
-   // Alias mcpServers → mcp (Claude Code / Copilot format compatibility)
-   if ("mcpServers" in copy && !("mcp" in copy)) {
-     copy.mcp = copy.mcpServers
-     delete copy.mcpServers
-     log.info("aliased mcpServers to mcp in config", { path: source })
-   }
    const hadLegacy = "theme" in copy || "keybinds" in copy || "tui" in copy
    if (hadLegacy) {
      delete copy.theme
      delete copy.keybinds
      delete copy.tui
      log.warn("tui keys in opencode config are deprecated; move them to tui.json", { path: source })
    }
    // altimate_change start — normalize mcpServers to mcp (common key used by other AI tools)
    return normalizeMcpConfig(copy, source)
    // altimate_change end
  })()
🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@packages/opencode/src/config/config.ts` around lines 1436 - 1441, The
duplicate top-level aliasing block that maps copy.mcpServers → copy.mcp
(checking "mcpServers" in copy && !("mcp" in copy") and logging) should be
removed so all MCP normalization is performed by normalizeMcpConfig(); delete
that if-block (the code referencing copy.mcpServers, copy.mcp and the log.info
call) and rely on normalizeMcpConfig() to handle both top-level aliasing and
per-server normalization to avoid dead code and duplication.

const hadLegacy = "theme" in copy || "keybinds" in copy || "tui" in copy
if (hadLegacy) {
delete copy.theme
Expand Down
Loading