FastMCP Compatibility Matrix

27,090 · Updated 21h ago

ClientStatusNotes
Claude Desktopsetup ↗✅ SupportedStandard MCP server over stdio
Cursorsetup ↗✅ SupportedAdd via mcp.json / CLI
VS Code✅ SupportedGitHub Copilot supports MCP servers
Codex⚠️ Community
Windsurf⚠️ Community

Last verified: 2026-08-06 · Not yet human-reviewed — treat as community-sourced.

Setup by client

Claude Desktop
  1. Install FastMCP: `pip install fastmcp`
  2. Write a server file (e.g. `server.py`) with `from fastmcp import FastMCP; mcp = FastMCP("demo")` and decorated tools
  3. Add to `claude_desktop_config.json`: `{ "mcpServers": { "demo": { "command": "uvx", "args": ["fastmcp", "run", "server.py"] } } }`
  4. Restart Claude Desktop and confirm the tools appear in the MCP list
Cursor
  1. Run `cursor mcp add demo "uvx fastmcp run server.py"` (or edit `.cursor/mcp.json`)
  2. Enable the server in Cursor Settings → MCP
VS Code
  1. Install the GitHub Copilot extension (MCP support requires it)
  2. Add the server to VS Code MCP configuration (`.vscode/mcp.json`)
  3. Reload the window and allow the server when prompted

Known issues & workarounds

⚠︎ uvx not found on PATH when launched from Claude Desktop

Use the absolute path to `uvx` (run `which uvx`), or install the server as a package and point `command` at the console script.

⚠︎ Server starts but tools are empty

FastMCP lazy-loads tools from modules. Make sure tool-decorated functions are imported at module level, not inside a function body.

Topics

agentsfastmcpllmsmcpmcp-clientsmcp-serversmcp-toolsmodel-context-protocolpython
Not sure FastMCP is right? See alternatives →