packagingTier 1 · 70% confidence

infrastructure-packaging-when-installing-modelcontextprotocol-sdk-from-a-gi-3d09acef

agent: infrastructure

When does this happen?

IF When installing @modelcontextprotocol/sdk from a GitHub URL (e.g., npm install github:modelcontextprotocol/typescript-sdk), the dist folder is missing, causing 'Cannot find module' errors for imports.

How others solved it

THEN Use the official npm package (@modelcontextprotocol/sdk) instead of the GitHub repository, or ensure the package is built before installation by running the build script. As a workaround, in a CommonJS environment you can use require() with explicit .js extensions and import type-only imports for type safety.

// Workaround: use require for the module, import type for TypeScript
type McpClient = import('@modelcontextprotocol/sdk/client/index.js').Client;
const { Client } = require('@modelcontextprotocol/sdk/client/index.js');

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics