Connection failures with npm-based MCP servers while uvx-based servers work correctly (Solved, see the comment in this post) #76

ChanMeng666 · 2024-11-27T04:58:12Z

Environment

System Information

OS: Windows 11 Home Chinese Edition
Version: 23H2
OS Build: 22631.4460
Installation Date: 2023/9/2
Windows Feature Experience Pack: 1000.22700.1047.0

Configuration File

Location: \Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sqlite": {
      "command": "uvx",
      "args": [
        "mcp-server-sqlite",
        "--db-path",
        "D:\\github_repository\\test.db"
      ]
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "D:\\github_repository",
        "D:\\github_repository\\image-generator"
      ]
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": ""
      }
    },
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost/mydb"
      ]
    },
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    },
    "puppeteer": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-puppeteer"
      ]
    },
    "brave-search": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-brave-search"
      ],
      "env": {
        "BRAVE_API_KEY": ""
      }
    },
    "google-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-google-maps"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": ""
      }
    },
    "fetch": {
      "command": "uvx",
      "args": [
        "mcp-server-fetch"
      ]
    }
  },
  "globalShortcut": "Ctrl+Q"
}

![2024-11-27 174538](https://github.com/user-attachments/assets/370df64f-3106-4dc5-9263-2517fb7fa87a)
![2024-11-27 174118](https://github.com/user-attachments/assets/291cb8de-e06a-4ccb-902c-b48b527c33dc)

The text was updated successfully, but these errors were encountered:

ChanMeng666 · 2024-11-27T05:29:16Z

Solution for MCP Servers Connection Issues with NVM/NPM

Background

This solution is inspired by and builds upon the workaround discussed in Issue #64. While the original solution was for macOS, this implementation is specifically for Windows systems using NVM (Node Version Manager).

Problem

When using NVM or standard Node.js installation, the default configuration using npx commands fails to connect MCP servers in Claude Desktop.

Solution Overview

The solution involves:

Installing MCP server packages globally instead of using npx
Using absolute paths to both the Node executable and server scripts
Modifying the configuration file to use these absolute paths

Step-by-Step Guide

1. Locate Node.js and npm paths

Open Command Prompt (CMD) as administrator and run:

where node

This will show your Node.js executable path. Example output:

D:\Program\nvm\node.exe

Then find your global npm packages location:

npm root -g

Example output:

D:\Program\nvm\node_modules

2. Install Required Packages Globally

Run these commands in CMD:

npm install -g @modelcontextprotocol/server-filesystem
npm install -g @modelcontextprotocol/server-github
npm install -g @modelcontextprotocol/server-memory
npm install -g @modelcontextprotocol/server-puppeteer
npm install -g @modelcontextprotocol/server-brave-search
npm install -g @modelcontextprotocol/server-google-maps
npm install -g @modelcontextprotocol/server-postgres

3. Verify Installations

Check each package installation:

npm list -g @modelcontextprotocol/server-filesystem
npm list -g @modelcontextprotocol/server-github
npm list -g @modelcontextprotocol/server-memory
npm list -g @modelcontextprotocol/server-puppeteer
npm list -g @modelcontextprotocol/server-brave-search
npm list -g @modelcontextprotocol/server-google-maps
npm list -g @modelcontextprotocol/server-postgres

Expected output format:

D:\Program\nvm -> .\
`-- @modelcontextprotocol/server-[package-name]@0.5.1

4. Update Configuration File

Modify your claude_desktop_config.json with the following content (adjust paths according to your system):

{
  "mcpServers": {
    "sqlite": {
      "command": "uvx",
      "args": [
        "mcp-server-sqlite",
        "--db-path",
        "D:\\github_repository\\test.db"
      ]
    },
    "filesystem": {
      "command": "D:\\Program\\nvm\\node.exe",
      "args": [
        "D:\\Program\\nvm\\node_modules\\@modelcontextprotocol\\server-filesystem\\dist\\index.js",
        "D:\\github_repository",
        "D:\\github_repository\\image-generator"
      ]
    },
    "github": {
      "command": "D:\\Program\\nvm\\node.exe",
      "args": [
        "D:\\Program\\nvm\\node_modules\\@modelcontextprotocol\\server-github\\dist\\index.js"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": ""
      }
    },
    "postgres": {
      "command": "D:\\Program\\nvm\\node.exe",
      "args": [
        "D:\\Program\\nvm\\node_modules\\@modelcontextprotocol\\server-postgres\\dist\\index.js",
        "postgresql://localhost/mydb"
      ]
    },
    "memory": {
      "command": "D:\\Program\\nvm\\node.exe",
      "args": [
        "D:\\Program\\nvm\\node_modules\\@modelcontextprotocol\\server-memory\\dist\\index.js"
      ]
    },
    "puppeteer": {
      "command": "D:\\Program\\nvm\\node.exe",
      "args": [
        "D:\\Program\\nvm\\node_modules\\@modelcontextprotocol\\server-puppeteer\\dist\\index.js"
      ]
    },
    "brave-search": {
      "command": "D:\\Program\\nvm\\node.exe",
      "args": [
        "D:\\Program\\nvm\\node_modules\\@modelcontextprotocol\\server-brave-search\\dist\\index.js"
      ],
      "env": {
        "BRAVE_API_KEY": ""
      }
    },
    "google-maps": {
      "command": "D:\\Program\\nvm\\node.exe",
      "args": [
        "D:\\Program\\nvm\\node_modules\\@modelcontextprotocol\\server-google-maps\\dist\\index.js"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": ""
      }
    },
    "fetch": {
      "command": "uvx",
      "args": [
        "mcp-server-fetch"
      ]
    }
  },
  "globalShortcut": "Ctrl+Q"
}

5. Important Notes

Replace all path references with your actual Node.js and npm paths
Use double backslashes (\\) in all Windows paths
Keep uvx commands unchanged
Make sure to add your API keys in the corresponding env sections if needed

6. Apply Changes

Save the modified configuration file
Close Claude Desktop completely
Restart Claude Desktop as administrator

Verification

After restart, all MCP servers should connect successfully. The uvx-based servers will continue to work as before, and the npm-based servers should now connect properly with the new configuration.

Troubleshooting

If you encounter issues:

Verify all paths exist using dir command
Check global package installations using npm list -g
Ensure Claude Desktop is running with administrator privileges
Double-check all backslashes in paths

This solution has been tested on Windows 11 (Build 22631.4460) with Node.js managed by NVM.

ntindle · 2024-11-27T08:07:22Z

I'm getting the opposite 😆

El-Invierno · 2024-11-27T08:56:55Z

Thanks a ton! Solved my issue.

rockywangxiaolei · 2024-11-27T09:46:06Z

thanks a lot, it works under windows 11.
highlight:make sure to check step 2 and step 3,especially the command has been executed successfully under step2.

dominicdev · 2024-11-27T11:32:07Z

trying to add simple DDG MCP, but getting error... any proper guides for python? in the docs seem having problem with the file dir.. working in windows

mcgraf · 2024-11-27T11:48:44Z

followed the instructions on windows 10, i only got memory and pupeteer working

rockywangxiaolei · 2024-11-27T12:50:17Z

followed the instructions on windows 10, i only got memory and pupeteer working

you may check the rest tools at step2(installed successful) and step3(the path alignment with config file )

jspahrsummers · 2024-11-27T14:14:49Z

Sorry, this is the same issue as #40. We're working on a fix. 🙏

angrysky56 · 2024-11-28T10:02:31Z

Perfect! Thanks so much. (Edit: The only one that didn't work was Github.)- Re-Edit, got Github working and made a repo, had to do some steps in Poweshell to post but easy enough considering I don't know how to code. Edited the JSON below for Github with what worked.

{
"mcpServers": {
"sqlite": {
"command": "uvx",
"args": [
"mcp-server-sqlite",
"--db-path",
"C:/Users/angry/OneDrive/Desktop/ai_workspace/core.db"
]
},
"filesystem": {
"command": "C:/Program Files/nodejs/node.exe",
"args": [
"C:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-filesystem/dist/index.js",
"C:/Users/angry/OneDrive/Desktop/ai_workspace",
"C:/Users/angry/OneDrive/Desktop/ai_workspace/servers"
]
},
"github": {
"command": "C:/Program Files/nodejs/node.exe",
"args": [
"C:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-github/dist/index.js"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "Your-token"
}
}
},
"postgres": {
"command": "C:/Program Files/nodejs/node.exe",
"args": [
"C:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-postgres/dist/index.js",
"postgresql://localhost/mydb"
]
},
"memory": {
"command": "C:/Program Files/nodejs/node.exe",
"args": [
"C:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-memory/dist/index.js"
]
},
"puppeteer": {
"command": "C:/Program Files/nodejs/node.exe",
"args": [
"C:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-puppeteer/dist/index.js"
]
},
"brave-search": {
"command": "C:/Program Files/nodejs/node.exe",
"args": [
"C:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-brave-search/dist/index.js"
],
"env": {
"BRAVE_API_KEY": ""
}
},
"google-maps": {
"command": "C:/Program Files/nodejs/node.exe",
"args": [
"C:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-google-maps/dist/index.js"
],
"env": {
"GOOGLE_MAPS_API_KEY": ""
}
},
"fetch": {
"command": "uvx",
"args": [
"mcp-server-fetch"
]
}
},
"globalShortcut": "Ctrl+Q"
}

mcgraf · 2024-11-28T10:14:42Z

followed the instructions on windows 10, i only got memory and pupeteer working

you may check the rest tools at step2(installed successful) and step3(the path alignment with config file )

I got it working , i had referenced the full path of the node executable instead of just "node"

angrysky56 · 2024-11-30T03:52:28Z

Let me fetch and examine that issue to better understand the uvx vs npx situation:

I apologize - let me try using the search function instead to find relevant information:

Ah, this is quite interesting! From what I can gather:

uvx is recommended for ease of use and setup, particularly for Python-based servers
npx is used for TypeScript/Node.js based servers but has had connection issues on Windows
mcp-server-sqlite specifically works better with uvx on Windows

Looking at your JSON configuration, you've cleverly used:

uvx for the SQLite server (which is Python-based)
direct Node.js path for the filesystem server (avoiding npx issues)

This explains why your setup works when others fail! The reason many people struggle is likely because they're trying to use npx for everything, not realizing the distinction between Python-based and TypeScript-based servers.

Given this understanding, I think we have a few options for implementing multi-database support:

We could check if mcp-server-sqlite supports any additional arguments for directory watching or multiple databases
We could write a simple Python script that acts as a database manager, since we know uvx works well
We could use the filesystem server (which is already working with multiple paths) to handle database file operations, then have the SQLite server attach to them

Would you like me to explore any of these approaches? Also, this explains how you got 49 tools working - you've managed to get both the Python (uvx) and Node.js based tools functioning correctly, which is quite an achievement!

Currently fully functioning JSON:

{
"mcpServers": {
"sqlite": {
"command": "uvx",
"args": [
"mcp-server-sqlite",
"--db-path",
"C:\Users\angry\OneDrive\Desktop\ai_workspace\sages_house\sqlite3_db_storage\core.db"
]
},
"filesystem": {
"command": "C:/Program Files/nodejs/node.exe",
"args": [
"C:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-filesystem/dist/index.js",
"C:/Users/angry/OneDrive/Desktop/ai_workspace",
"C:/Users/angry/OneDrive/Desktop/ai_workspace/memory",
"F:/",
"D:/"

  ]
},
"github": {
  "command": "C:/Program Files/nodejs/node.exe",
  "args": [
    "C:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-github/dist/index.js",
    "https://github.com/angrysky56"
  ],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "x"
  }
},
"postgres": {
  "command": "C:/Program Files/nodejs/node.exe",
  "args": [
    "C:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-postgres/dist/index.js",
    "postgresql://localhost/mydb"
  ]
},
"memory": {
  "command": "C:/Program Files/nodejs/node.exe",
  "args": [
    "C:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-memory/dist/index.js"
  ]
},
"puppeteer": {
  "command": "C:/Program Files/nodejs/node.exe",
  "args": [
    "C:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-puppeteer/dist/index.js"
  ]
},
"brave-search": {
  "command": "C:/Program Files/nodejs/node.exe",
  "args": [
    "C:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-brave-search/dist/index.js"
  ],
  "env": {
    "BRAVE_API_KEY": "x"
  }
},
"google-maps": {
  "command": "C:/Program Files/nodejs/node.exe",
  "args": [
    "C:/Program Files/nodejs/node_modules/@modelcontextprotocol/server-google-maps/dist/index.js"
  ],
  "env": {
    "GOOGLE_MAPS_API_KEY": "x"
  }
},
"fetch": {
  "command": "uvx",
  "args": [
    "mcp-server-fetch"
  ]
}

},
"globalShortcut": "Ctrl+Q"
}

ZubeidHendricks · 2024-12-02T09:37:50Z

Thank you, this worked for me

ChanMeng666 changed the title ~~Connection failures with npm-based MCP servers while uvx-based servers work correctly~~ Connection failures with npm-based MCP servers while uvx-based servers work correctly (Solved, see the comment in this post) Nov 27, 2024

jspahrsummers closed this as not planned Won't fix, can't repro, duplicate, stale Nov 27, 2024

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Connection failures with npm-based MCP servers while uvx-based servers work correctly (Solved, see the comment in this post) #76

Connection failures with npm-based MCP servers while uvx-based servers work correctly (Solved, see the comment in this post) #76

ChanMeng666 commented Nov 27, 2024

ChanMeng666 commented Nov 27, 2024

ntindle commented Nov 27, 2024

El-Invierno commented Nov 27, 2024

rockywangxiaolei commented Nov 27, 2024

dominicdev commented Nov 27, 2024

mcgraf commented Nov 27, 2024

rockywangxiaolei commented Nov 27, 2024

jspahrsummers commented Nov 27, 2024

angrysky56 commented Nov 28, 2024 •

edited

Loading

mcgraf commented Nov 28, 2024

angrysky56 commented Nov 30, 2024

ZubeidHendricks commented Dec 2, 2024

Connection failures with npm-based MCP servers while uvx-based servers work correctly (Solved, see the comment in this post) #76

Connection failures with npm-based MCP servers while uvx-based servers work correctly (Solved, see the comment in this post) #76

Comments

ChanMeng666 commented Nov 27, 2024

Environment

System Information

Configuration File

ChanMeng666 commented Nov 27, 2024

Solution for MCP Servers Connection Issues with NVM/NPM

Background

Problem

Solution Overview

Step-by-Step Guide

1. Locate Node.js and npm paths

2. Install Required Packages Globally

3. Verify Installations

4. Update Configuration File

5. Important Notes

6. Apply Changes

Verification

Troubleshooting

ntindle commented Nov 27, 2024

El-Invierno commented Nov 27, 2024

rockywangxiaolei commented Nov 27, 2024

dominicdev commented Nov 27, 2024

mcgraf commented Nov 27, 2024

rockywangxiaolei commented Nov 27, 2024

jspahrsummers commented Nov 27, 2024

angrysky56 commented Nov 28, 2024 • edited Loading

mcgraf commented Nov 28, 2024

angrysky56 commented Nov 30, 2024

Currently fully functioning JSON:

ZubeidHendricks commented Dec 2, 2024

angrysky56 commented Nov 28, 2024 •

edited

Loading