Home

Welcome to the mcp-linker wiki!

• How It Works
• Troubleshooting

🛠️ How It Works

When you click "Add", MCP Linker directly modifies your MCP configuration file to include the selected server.

⚠️ Warning: This will overwrite existing MCP configuration for that client. Please back up your config file if needed.

📂 Configuration File Paths

Claude Desktop

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: ~/AppData/Roaming/Claude/claude_desktop_config.json

Cursor

• Global config: ~/.cursor/mcp.json
• Project config: .cursor/mcp.json

Windsurf

• ~/.codeium/windsurf/mcp_config.json

🔍 Troubleshooting

I suggest use bun, Why use bun, because docker arm.

I fixed the package.json no msvc issue.

@tailwindcss/oxide-win32-x64-msvc
@rollup/rollup-win32-x64-msvc

If you use npm change bun to npm at src-tauri/tauri.conf.json:

{
    "beforeDevCommand": "bun run dev",
    "beforeBuildCommand": "bun run build",
}

{
    "beforeDevCommand": "npm run dev",
    "beforeBuildCommand": "npm run build",
}

If you encounter installation issues:

1. Remove dependency lock files:

   rm package-lock.json
   rm -rf node_modules

2. Clean npm cache and reinstall:

   npm cache clean --force
   npm install

3. If errors persist, try with legacy peer deps:

   npm cache clean --force
   npm install --legacy-peer-deps