Serverdex error reference · read 21 November 2026

MODULE_NOT_FOUND / No module named mcp.server.fastmcp: what it means and how to fix it

MODULE_NOT_FOUND · No module named mcp.server.fastmcp

The server process started but its own imports failed: a Node server cannot find a module it requires, or a Python server imports `mcp.server.fastmcp` from an SDK version where that path no longer exists. The client then reports a connection failure; the real message is in the server's stderr.

Shown by: all clients (Node and Python servers)

Causes, most likely first — and the fix for each

  1. 1Node: the package was run from a directory without its dependencies installed, or `npx` resolved a different version than the server expects.

    Fix: Run `npm install` in the server's directory, or pin the package version in the `npx -y <package>@<version>` argument.

  2. 2Python: the MCP SDK changed module paths between major versions; a server written for v1 imports fail under v2 (and the reverse).

    Fix: Pin the `mcp` package version the server was written for (`uvx --from 'mcp==<version>' …` or the project's lock file), or update the server to the current import path.

Still failing?

Work through the twelve general causes in order in MCP server not working: the causes, in order, check the exact config file path and shape for your client in the client setup guides, or generate a known-good config with the config generator.

Sources (read 21 November 2026)

Other MCP errors: MCP error -32000: Connection closed · MCP error -32001: Request timed out · MCP error -32601: Method not found · MCP error -32602: Invalid params · MCP error -32603: Internal error · MCP error -32600: Invalid request · HTTP 406 Not Acceptable from an MCP server · spawn npx ENOENT · spawn uvx ENOENT (and uv, docker) · Server transport closed unexpectedly · Client closed (Cursor) · No tools, prompts, or resources (Cursor) · Unexpected token … is not valid JSON · SSE error: Invalid content type, expected text/event-stream · Could not attach to MCP server (Claude Desktop) · Failed to reconnect to an MCP server (Claude Code) · MCP server needs authentication (401 Unauthorized) · MCP OAuth loop (infinite sign-in tabs) · Tools limited to 40 total (Cursor) · executable file not found in $PATH (Antigravity).