Call FastMCP servers from Claude Desktop
uv
commands.server.py
.
New in version: 2.10.3
The easiest way to install a FastMCP server in Claude Desktop is using the fastmcp install claude-desktop
command. This automatically handles the configuration and dependency management.
fastmcp install <path>
without specifying the client.file.py:object
notation as the run
command. If no object is specified, it will automatically look for a FastMCP server object named mcp
, server
, or app
in your file:
--with
flag to specify packages your server needs. You can use this flag multiple times:
requirements.txt
file listing all your dependencies, use --with-requirements
to install them all at once:
--with-editable
to install them in editable mode:
--python
to specify which Python version your server should run with. This is particularly useful when your server requires a specific Python version:
--project
to run your server within a specific project directory. This ensures that uv
will discover all pyproject.toml
, uv.toml
, and .python-version
files from that project:
.env
file:
uv
must be installed and available in your system PATH. Claude Desktop runs in its own isolated environment and needs uv
to manage dependencies.uv
globally with Homebrew so that Claude Desktop will detect it: brew install uv
. Installing uv
with other methods may not make it accessible to Claude Desktop.~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
mcpServers
key, which contains the configuration for each MCP server.
uv
or another package manager to set up the environment.
When manually configuring dependencies, the recommended approach is to use uv
with FastMCP. The configuration uses uv run
to create an isolated environment with your specified packages:
--python
to use a specific Python version, or --project
to run within a project directory:
uv
must be installed and available in your system PATH. Claude Desktop runs in its own isolated environment and needs uv
to manage dependencies.uv
globally with Homebrew so that Claude Desktop will detect it: brew install uv
. Installing uv
with other methods may not make it accessible to Claude Desktop.