A step-by-step guide to setting up Model Context Protocol (MCP) servers for Claude Desktop on Windows.
-
Install Node.js (v18.x or later)
- Download from: https://nodejs.org/
- Verify installation by opening PowerShell and running:
node --version npm --version
-
Install Python 3.10 or later (for Python-based servers)
- Download from: https://www.python.org/downloads/
- Make sure to check "Add Python to PATH" during installation
Open PowerShell as administrator and run:
# For Python-based servers
npm install -g uv
# Install servers globally
npm install -g @modelcontextprotocol/server-memory
npm install -g @modelcontextprotocol/server-everything
npm install -g @modelcontextprotocol/server-brave-search
# ... other servers you want to install
# Using uvx
uvx mcp-server-sqlite
- Navigate to:
%AppData%\Claude Desktop\
- Create or edit
claude_desktop_config.json
- Use this configuration structure:
{
"globalShortcut": "Ctrl+Space",
"mcpServers": {
"sqlite": {
"command": "uvx",
"args": ["mcp-server-sqlite", "--db-path", "C:\\Users\\YourUsername\\test.db"]
},
"memory": {
"command": "node",
"args": ["C:\\Users\\YourUsername\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-memory\\dist\\index.js"],
"env": {
"DEBUG": "*"
}
},
"everything": {
"command": "node",
"args": ["C:\\Users\\YourUsername\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-everything\\dist\\index.js"],
"env": {
"DEBUG": "*"
}
},
"brave-search": {
"command": "node",
"args": ["C:\\Users\\YourUsername\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-brave-search\\dist\\index.js"],
"env": {
"BRAVE_API_KEY": "YOUR_API_KEY_HERE",
"DEBUG": "*"
}
}
}
}
Important:
- Replace
YourUsername
with your Windows username - Replace
YOUR_API_KEY_HERE
with your actual API key for services that require it - Use double backslashes (\) in all Windows paths
- Point to the
dist/index.js
file in the npm modules directory
- Only requires the basic setup shown above
- Customize the
--db-path
argument to your preferred location
- No additional setup required
- Debug logging enabled by default
- No additional setup required
- Debug logging enabled by default
- Get API key from https://brave.com/search/api/
- Add it to the config's env section as shown above
# List installed packages
npm list -g --depth=0
# Test individual servers
npx @modelcontextprotocol/server-memory
npx @modelcontextprotocol/server-brave-search
uvx mcp-server-sqlite
-
"Could not attach to MCP server"
- Verify the paths in config match your system
- Make sure all packages are installed globally (-g flag)
- Check that dist/index.js exists in the specified paths
-
Server not showing in Claude
- Restart Claude Desktop
- Verify JSON syntax in config file
- Check file paths are correct
- Always use global installations (
npm install -g
) - Use full paths to
dist/index.js
in the config - Keep DEBUG env variable for troubleshooting
- Restart Claude Desktop after config changes