Skip to content

Installation

Jump to bottom
j0KZ edited this page Oct 7, 2025 · 1 revision

Installation Guide

Complete installation instructions for all supported editors.

🚀 Quick Install (Recommended)

All Editors - One Command

npx @j0kz/mcp-agents@latest

The installer will:

  1. Auto-detect your editor (Claude Code, Cursor, Windsurf, VS Code, Roo Code)
  2. Install all 9 MCP tools
  3. Configure your editor automatically
  4. Clear npm cache to prevent issues
  5. Validate and fix malformed config files

After installation: Restart your editor to load the tools.

📱 Editor-Specific Installation

Claude Code

Automatic (Recommended):

npx @j0kz/mcp-agents@latest

Manual Configuration:

  1. Locate config file:

    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

  2. Add MCP servers:

{
  "mcpServers": {
    "smart-reviewer": {
      "command": "npx",
      "args": ["-y", "@j0kz/smart-reviewer-mcp@latest"]
    },
    "test-generator": {
      "command": "npx",
      "args": ["-y", "@j0kz/test-generator-mcp@latest"]
    },
    "architecture-analyzer": {
      "command": "npx",
      "args": ["-y", "@j0kz/architecture-analyzer-mcp@latest"]
    },
    "security-scanner": {
      "command": "npx",
      "args": ["-y", "@j0kz/security-scanner-mcp@latest"]
    },
    "refactor-assistant": {
      "command": "npx",
      "args": ["-y", "@j0kz/refactor-assistant-mcp@latest"]
    },
    "api-designer": {
      "command": "npx",
      "args": ["-y", "@j0kz/api-designer-mcp@latest"]
    },
    "db-schema": {
      "command": "npx",
      "args": ["-y", "@j0kz/db-schema-mcp@latest"]
    },
    "doc-generator": {
      "command": "npx",
      "args": ["-y", "@j0kz/doc-generator-mcp@latest"]
    },
    "orchestrator": {
      "command": "npx",
      "args": ["-y", "@j0kz/orchestrator-mcp@latest"]
    }
  }
}
  1. Restart Claude Code

Cursor

Automatic (Recommended):

npx @j0kz/mcp-agents@latest cursor

Manual Configuration:

  1. Create/edit .cursorrules or .cursor/mcp.json in your project root
  2. Add the same MCP server configuration as Claude Code above
  3. Restart Cursor

Windsurf

Automatic (Recommended):

npx @j0kz/mcp-agents@latest windsurf

Manual Configuration:

  1. Create/edit .windsurfrules in your project root
  2. Add the same MCP server configuration as Claude Code above
  3. Restart Windsurf

VS Code (with Continue or other MCP extensions)

Automatic (Recommended):

npx @j0kz/mcp-agents@latest vscode

Manual Configuration:

Configuration depends on your MCP extension. Typically:

  1. Install an MCP-compatible extension (Continue, Cline, etc.)
  2. Add MCP server configuration to extension settings
  3. Restart VS Code

Roo Code

Automatic (Recommended):

npx @j0kz/mcp-agents@latest roo

Manual Configuration:

  1. Create/edit .roo/mcp.json in your project root
  2. Add the same MCP server configuration as Claude Code above
  3. Restart Roo Code

🔧 Install Individual Tools

If you only need specific tools, install them individually:

# Smart Reviewer only
npx @j0kz/mcp-agents@latest --tools smart-reviewer

# Multiple specific tools
npx @j0kz/mcp-agents@latest --tools smart-reviewer,test-generator,security-scanner

Or manually add only the tools you want to your editor's config file.

✅ Verify Installation

Method 1: Check in Editor

  1. Restart your editor
  2. Start a new chat
  3. Type @ and you should see all installed MCP tools listed
  4. Try using a tool: "Review this file with smart-reviewer"

Method 2: Check Config File

Claude Code (Windows):

cat $env:APPDATA\Claude\claude_desktop_config.json

Claude Code (macOS/Linux):

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

Cursor/Windsurf:

cat .cursorrules
# or
cat .cursor/mcp.json

You should see all 9 MCP tools listed under mcpServers.

Method 3: Test a Tool

Try this in your editor's chat:

Use smart-reviewer to analyze this code:
function add(a, b) {
  console.log(a, b);
  return a + b;
}

You should get a detailed code review with metrics and suggestions.

🔄 Updating

Update All Tools

npx @j0kz/mcp-agents@latest

The installer will automatically update all tools to the latest versions.

Update Individual Tool

Edit your config file and change the version:

{
  "smart-reviewer": {
    "command": "npx",
    "args": ["-y", "@j0kz/smart-reviewer-mcp@1.0.35"]
  }
}

Or use @latest to always get the newest version:

{
  "smart-reviewer": {
    "command": "npx",
    "args": ["-y", "@j0kz/smart-reviewer-mcp@latest"]
  }
}

🗑️ Uninstalling

Remove from Config

Automatic:

npx @j0kz/mcp-agents@latest --uninstall

Manual:

  1. Open your editor's config file
  2. Remove the mcpServers section or individual tools
  3. Restart your editor

Clear npm Cache

npm cache clean --force

🆘 Troubleshooting

Tools not showing up

  1. Restart your editor (required after any config changes)
  2. Check config file syntax (must be valid JSON)
  3. Run installer again: npx @j0kz/mcp-agents@latest

Permission errors

Windows:

# Run PowerShell as Administrator
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

macOS/Linux:

# Clear npm cache
npm cache clean --force

# Try again
npx @j0kz/mcp-agents@latest

Config file is malformed

The installer auto-fixes JSON errors. If issues persist:

# Backup config
cp ~/.config/claude/claude_desktop_config.json ~/.config/claude/claude_desktop_config.json.backup

# Reinstall
npx @j0kz/mcp-agents@latest

npm errors

# Clear cache
npm cache clean --force

# Update npm
npm install -g npm@latest

# Try again
npx @j0kz/mcp-agents@latest

📋 System Requirements

  • Node.js: 18.x or higher
  • npm: 8.x or higher
  • Editor: Claude Code, Cursor, Windsurf, VS Code, or Roo Code
  • OS: Windows, macOS, or Linux

🔗 Related Pages

Need help? Open an issue

Clone this wiki locally