Claude Desktop MCP Server Config Guide & Setup

How to configure local and remote Model Context Protocol (MCP) servers in Claude Desktop on macOS and Linux.

Configuration File Location

Claude Desktop reads its tool definitions from a JSON file located at:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Zero-Install uvx Configuration

Using Astral's uvx utility, Claude Desktop can invoke MCP servers directly from GitHub repositories without requiring manual cloning or virtual environment setup:

{
  "mcpServers": {
    "crawlengine": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/johannschiffer/crawlengine-mcp", "crawlengine-mcp"]
    },
    "pgsafe": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/johannschiffer/pgsafe-mcp", "pgsafe-mcp"]
    }
  }
}
Ready to connect these capabilities?
Generate your configuration file in one click with the Genesis Config Builder.