DF0017: MCP Server Start Failure

Package: devframe

Experimental

The agent-native surface is experimental and may change without a major version bump until it stabilizes.

Message

Failed to start MCP server ({transport}): {reason}

Cause

createMcpServer() failed while initializing. Common reasons:

• @modelcontextprotocol/sdk is not installed. This is a peer dependency — add it to your devtool's dependencies.
• The selected transport is not yet implemented (the first devframe MCP release ships with stdio only; http is planned).
• The underlying transport threw during connect() (e.g. stdin/stdout is not available).

Fix

• Missing SDK: pnpm add @modelcontextprotocol/sdk (or npm/yarn equivalent) in the package that imports devframe/adapters/mcp.
• Unsupported transport: pass { transport: 'stdio' } until HTTP support lands.
• Transport init failure: check the underlying error (attached as cause) for specifics.

Source

packages/devframe/src/node/mcp/build-server.ts