mcp - kdevkr/mambo-box GitHub Wiki

μ•€νŠΈλ‘œν”½μ΄ 2024λ…„ 11월에 μ†Œκ°œν•œ Model Context Protocol(MCP)λŠ” 에이전틱 AIλ₯Ό μœ„ν•œ ν˜ΈμΆœμ— μ‚¬μš©λ˜λŠ” 사싀 상 ν‘œμ€€.

Requirements

claude_desktop_config.json

C:\Users\Mambo\AppData\Roaming\Claude\calude_desktop_config.json

MCP μ„œλ²„ μ„€μ • νŠΈλŸ¬λΈ”μŠˆνŒ…

command not found: /Users/eip/Desktop

  • nvm 을 μ‚¬μš©ν•˜μ—¬ λ…Έλ“œ 버전을 κ΄€λ¦¬ν•˜λŠ” 경우 Claude Desktop μ—μ„œ μ‚¬μš©ν•˜λŠ” λ…Έλ“œ 버전이 λ‹€λ₯Έ λ¬Έμ œκ°€ λ°œμƒν•¨.
  • servers#64λ₯Ό μ°Έκ³ ν•˜λ©΄ /usr/local/bin/npx-for-mcp λ₯Ό λ§Œλ“€μ–΄μ„œ nvm 으둜 μ„€μΉ˜λœ λ…Έλ“œ 버전을 μ‚¬μš©ν•˜λ„λ‘ μ„€μ • κ°€λŠ₯
{
  "mcpServers": {
    "filesystem": {
      "command": "npx-for-mcp",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/USERNAME/Desktop",
        "/Users/USERNAME/Documents",
        "/Users/USERNAME/Downloads"
      ]
    },
  }
}

import: command not found

npx-for-mcp λ₯Ό μ‚¬μš©ν–ˆλŠ”λ° server-redis μ—μ„œλŠ” κ·ΈλŒ€λ‘œ 였λ₯˜κ°€ λ°œμƒν–ˆμŒ,

/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 1: import: command not found
/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 2: import: command not found
/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 3: import: command not found
/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 4: import: command not found
/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 5: import: command not found
/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 6: //: is a directory
/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 7: const: command not found
/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 7: redis://localhost:6379: No such file or directory
/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 8: const: command not found
/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 9: const: command not found
/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 9: //: is a directory
/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 10: const: command not found
/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 10: //: is a directory
/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 11: //: is a directory
/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 12: syntax error near unexpected token `('
/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis: line 12: `const redisClient = createClient({'

{
  "mcpServers": {
    "redis": {
      "command": "/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/node",
      "args": [
        "/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/redis",
        "redis://localhost:6379"
      ]
    }
  }
}

ls: /.nvm/versions/node: No such file or directory

@modelcontextprotocol/server-gdrive의 κ²½μš°λ„

ls: /.nvm/versions/node: No such file or directory

ERROR: You must supply a command.

Execute binaries from npm packages.

  npx [options] <command>[@version] [command-arg]...

  npx [options] [-p|--package <package>]... <command> [command-arg]...

  npx [options] -c '<command-string>'

  npx --shell-auto-fallback [shell]


Options:
  --package, -p          Package to be installed.                       [string]
  --cache                Location of the npm cache.                     [string]
  --always-spawn         Always spawn a child process to execute the command.
                                                                       [boolean]
  --no-install           Skip installation if a package is missing.    [boolean]
  --userconfig           Path to user npmrc.                            [string]
  --call, -c             Execute string as if inside `npm run-script`.  [string]
  --shell, -s            Shell to execute the command with, if any.
                                                       [string] [default: false]
  --shell-auto-fallback  Generate shell code to use npx as the "command not
                         found" fallback.
                                   [string] [choices: "", "bash", "fish", "zsh"]
  --ignore-existing      Ignores existing binaries in $PATH, or in the local
                         project. This forces npx to do a temporary install and
                         use the latest version.                       [boolean]
  --quiet, -q            Suppress output from npx itself. Subcommands will not
                         be affected.                                  [boolean]
  --npm                  npm binary to use for internal operations.
                                                              [string] [default:
  "/Users/USERNAME/.nvm/versions/node/v12.22.12/lib/node_modules/npm/bin/npm-cli.js"]
  --node-arg, -n         Extra node argument when calling a node binary.[string]
  --version, -v          Show version number                           [boolean]
  --help, -h             Show help                                     [boolean]

For the full documentation, see the manual page for npx(1).
{
  "mcpServers": {
    "gdrive": {
      "command": "/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/node",
      "args": [
        "/Users/USERNAME/.nvm/versions/node/v22.14.0/bin/mcp-server-gdrive"
      ],
      "env": {
        "GDRIVE_CREDENTIALS_PATH": "/Users/USERNAME/servers/.gdrive-server-credentials.json"
      }
    }
  }
}

ERROR: You must supply a command.

2025-04-09T04:52:11.180Z [sequential-thinking] [info] Initializing server...
2025-04-09T04:52:11.216Z [sequential-thinking] [info] Server started and connected successfully
2025-04-09T04:52:11.217Z [sequential-thinking] [info] Message from client: {"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"claude-ai","version":"0.1.0"}},"jsonrpc":"2.0","id":0}

ERROR: You must supply a command.

Execute binaries from npm packages.

  npx [options] <command>[@version] [command-arg]...

  npx [options] [-p|--package <package>]... <command> [command-arg]...

  npx [options] -c '<command-string>'

  npx --shell-auto-fallback [shell]


Options:
  --package, -p          Package to be installed.                       [string]
  --cache                Location of the npm cache.                     [string]
  --always-spawn         Always spawn a child process to execute the command.
                                                                       [boolean]
  --no-install           Skip installation if a package is missing.    [boolean]
  --userconfig           Path to user npmrc.                            [string]
  --call, -c             Execute string as if inside `npm run-script`.  [string]
  --shell, -s            Shell to execute the command with, if any.
                                                       [string] [default: false]
  --shell-auto-fallback  Generate shell code to use npx as the "command not
                         found" fallback.
                                   [string] [choices: "", "bash", "fish", "zsh"]
  --ignore-existing      Ignores existing binaries in $PATH, or in the local
                         project. This forces npx to do a temporary install and
                         use the latest version.                       [boolean]
  --quiet, -q            Suppress output from npx itself. Subcommands will not
                         be affected.                                  [boolean]
  --npm                  npm binary to use for internal operations.
                                                              [string] [default:
  "/Users/USERNAME/.nvm/versions/node/v12.22.12/lib/node_modules/npm/bin/npm-cli.js"]
  --node-arg, -n         Extra node argument when calling a node binary.[string]
  --version, -v          Show version number                           [boolean]
  --help, -h             Show help                                     [boolean]

For the full documentation, see the manual page for npx(1).
2025-04-09T04:52:11.741Z [sequential-thinking] [info] Server transport closed
2025-04-09T04:52:11.741Z [sequential-thinking] [info] Client transport closed
2025-04-09T04:52:11.742Z [sequential-thinking] [info] Server transport closed unexpectedly, this is likely due to the process exiting early. If you are developing this MCP server you can add output to stderr (i.e. `console.error('...')` in JavaScript, `print('...', file=sys.stderr)` in python) and it will appear in this log.
2025-04-09T04:52:11.742Z [sequential-thinking] [error] Server disconnected. For troubleshooting guidance, please visit our [debugging documentation](https://modelcontextprotocol.io/docs/tools/debugging) {"context":"connection"}

spawn uvx ENOENT

Model Context Protocol servers 쀑 time, git, sqlite, fetch 등은 Python MCP SDK둜 μž‘μ„±λ˜μ–΄μžˆμ–΄ uv νŒ¨ν‚€μ§€ λ§€λ‹ˆμ €κ°€ μ„€μΉ˜λ˜μ–΄μžˆμ–΄μ•Ό ν•œλ‹€. λ§₯ ν™˜κ²½μ— μ„€μΉ˜λœ uv의 κ²½λ‘œκ°€ /Users/USERNAME/.local/bin에 μžˆλ‹€λ©΄ Claude Desktop μ—μ„œ 바라보지 λͺ»ν•  수 μžˆμœΌλ―€λ‘œ 전체 경둜λ₯Ό μ§€μ •ν•΄μ£Όκ±°λ‚˜ brew install uv 둜 μ„€μΉ˜ν•΄λ„ λœλ‹€.

2025-04-09T04:55:27.164Z [time] [info] Initializing server...
2025-04-09T04:55:27.186Z [time] [error] spawn uvx ENOENT {"context":"connection","stack":"Error: spawn uvx ENOENT\n    at ChildProcess._handle.onexit (node:internal/child_process:285:19)\n    at onErrorNT (node:internal/child_process:483:16)\n    at process.processTicksAndRejections (node:internal/process/task_queues:82:21)"}
2025-04-09T04:55:27.187Z [time] [error] spawn uvx ENOENT {"stack":"Error: spawn uvx ENOENT\n    at ChildProcess._handle.onexit (node:internal/child_process:285:19)\n    at onErrorNT (node:internal/child_process:483:16)\n    at process.processTicksAndRejections (node:internal/process/task_queues:82:21)"}
2025-04-09T04:55:27.188Z [time] [info] Server transport closed
2025-04-09T04:55:27.188Z [time] [info] Client transport closed
2025-04-09T04:55:27.189Z [time] [info] Server transport closed unexpectedly, this is likely due to the process exiting early. If you are developing this MCP server you can add output to stderr (i.e. `console.error('...')` in JavaScript, `print('...', file=sys.stderr)` in python) and it will appear in this log.
2025-04-09T04:55:27.189Z [time] [error] Server disconnected. For troubleshooting guidance, please visit our [debugging documentation](https://modelcontextprotocol.io/docs/tools/debugging) {"context":"connection"}
{
  "mcpServers": {
    "time": {
      "command": "/Users/USERNAME/.local/bin/uvx",
      "args": ["mcp-server-time", "--local-timezone=Asia/Seoul"]
    }
  }
}

Github MCP failed with PAT

ref: github-mcp-server#153

μœ„ 이슈처럼 Fine-grained PATλ₯Ό μ‚¬μš©ν•˜λŠ” 경우 전체 μ•‘μ„ΈμŠ€ κΆŒν•œμ„ 뢀여해도 쑰직 λ¦¬νŒŒμ§€ν† λ¦¬μ— μ ‘κ·Όν•  수 μ—†μ—ˆλ‹€. μ•„λž˜ 이미지와 같이 μ‘°μ§μ—μ„œ μ•‘μ„ΈμŠ€ 토큰 μ‚¬μš©μ— λŒ€ν•œ κΆŒν•œμ„ μ œν•œλœ 뢀뢄은 μ—†λŠ” μƒνƒœμ΄λ‹€.

image

Add a custom footer
⚠️ **GitHub.com Fallback** ⚠️