DF0017: MCP Server Start Failure
Failed to start MCP server ({transport}): {reason}
Message
Failed to start MCP server ({transport}):{reason}
Cause
The MCP server failed while initializing. Common reasons:
- The stdio transport threw during
connect()(e.g. stdin/stdout unavailable). - The MCP adapter module could not be loaded (e.g. a corrupted install missing
@modelcontextprotocol/server).
Fix
- Transport failure: inspect the underlying error attached as
cause. - Broken install: reinstall dependencies so
@modelcontextprotocol/server(a dependency ofdevframe) resolves.
Source
packages/devframe/src/adapters/mcp/build-server.ts:createMcpServer()throwsDF0017when the stdio transport fails toconnect().packages/devframe/src/adapters/dev.ts:createDevServer()throwsDF0017(transporthttp) when the route-based MCP server can't load its transport module.