Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Inconsistent configuration requirements for different MCP server installation methods #460

Open
ChanMeng666 opened this issue Jan 2, 2025 · 0 comments
Labels
bug Something isn't working

Comments

@ChanMeng666
Copy link

ChanMeng666 commented Jan 2, 2025

Describe the bug
There is an inconsistency in the required configuration for MCP servers in claude_desktop_config.json depending on how they were installed. Specifically:

  • Servers installed via npm install -g require "command": "D:\\Program\\nvm\\node.exe" configuration
  • Servers installed via npx @smithery/cli install require "command": "npx" configuration

Using the wrong configuration type results in MCP connection errors, but this requirement is not documented and may cause confusion for users.

To Reproduce
Steps to reproduce the behavior:

  1. Install MCP servers using different methods:
    # Method 1: Global NPM install
    npm install -g @modelcontextprotocol/server-sequential-thinking
    npm install -g exa-mcp-server
    
    # Method 2: Smithery CLI install
    npx @smithery/cli install mcp-obsidian --client claude
    npx @smithery/cli install @browserbasehq/mcp-browserbase --client claude
  2. Try configuring all servers with "command": "npx"
  3. Try configuring all servers with "command": "D:\\Program\\nvm\\node.exe"
  4. Observe that each installation method requires its specific configuration approach

Expected behavior

  • Configuration method should be consistent regardless of installation method
  • If different configuration methods are required, this should be clearly documented in the README
  • Ideally, there should be a single recommended way to configure MCP servers to avoid confusion

Logs
System information:

Microsoft Windows [Version 10.0.26100.2605]
Node location: D:\Program\nvm\node.exe
Global npm root: D:\Program\nvm\node_modules

Installation logs and configuration file:

C:\Users\0>npm install -g @modelcontextprotocol/server-sequential-thinking
added 32 packages in 13s

C:\Users\0>npm install -g exa-mcp-server
added 25 packages in 5s

C:\Users\0>npx @smithery/cli install mcp-obsidian --client claude
[...]
✓ Successfully installed package 'mcp-obsidian' for claude

C:\Users\0>npx -y @smithery/cli install @browserbasehq/mcp-browserbase --client claude
[...]
✓ Successfully installed package '@browserbasehq/mcp-browserbase' for claude

Current working configuration in claude_desktop_config.json:

{
    "sequential-thinking": {
      "command": "D:\\Program\\nvm\\node.exe",
      "args": [
        "D:\\Program\\nvm\\node_modules\\@modelcontextprotocol\\server-sequential-thinking\\dist\\index.js"
      ]
    },
    "exa": {
      "command": "D:\\Program\\nvm\\node.exe",
      "args": [
        "D:\\Program\\nvm\\node_modules\\exa-mcp-server\\build\\index.js"
      ],
      "env": {
        "EXA_API_KEY": ""
      }
    },
    "mcp-obsidian": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-obsidian",
        "D:\\github_repository\\obsidian"
      ]
    },
    "@browserbasehq-mcp-browserbase": {
      "command": "npx",
      "args": [
        "-y",
        "@browserbasehq/mcp-browserbase"
      ],
      "env": {
        "BROWSERBASE_API_KEY": "",
        "BROWSERBASE_PROJECT_ID": ""
      }
    }
}

Additional context
This inconsistency makes it difficult for users to set up multiple MCP servers, as they need to remember or figure out which configuration method to use based on how each server was installed. A unified configuration approach would greatly improve the user experience.


Configuration information for MCP applications installed using npm install -g :

Configuration information for successful connection:

屏幕截图 2025-01-02 224908
屏幕截图 2025-01-02 225018

Configuration information when the connection fails:

屏幕截图 2025-01-02 225347
屏幕截图 2025-01-02 225355


Configuration information for MCP applications installed using npx -y @smithery/cli install :

Configuration information for successful connection:

屏幕截图 2025-01-02 225027
屏幕截图 2025-01-02 225037

Configuration information when the connection fails:

屏幕截图 2025-01-02 225404
屏幕截图 2025-01-02 225414
屏幕截图 2025-01-02 225530


CMD operation log:

屏幕截图 2025-01-02 230117

@ChanMeng666 ChanMeng666 added the bug Something isn't working label Jan 2, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working
Projects
None yet
Development

No branches or pull requests

1 participant