Skip to content

Getting Started

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

Getting Started

Welcome to the MCP Agent Toolkit! This guide will help you get up and running in minutes.

Table of Contents

  1. Prerequisites
  2. Installation
  3. Configuration
  4. First Steps
  5. Troubleshooting

Prerequisites

Before installing, ensure you have:

  • Node.js: Version 18 or higher
  • npm: Version 9 or higher
  • Editor: One of the following:
    • Claude Code (claude.ai/code)
    • Cursor
    • Windsurf
    • VS Code with MCP extension
    • Any MCP-compatible editor

Installation

Automatic Installation (Recommended)

The easiest way to install all tools:

npx @j0kz/mcp-agents@latest

This command will:

  1. Detect your editor automatically
  2. Install all 9 MCP tools
  3. Configure them in your editor
  4. Clear npm cache to prevent conflicts
  5. Fix any malformed config files

Manual Installation

If you prefer to install specific tools:

# Install individual tools globally
npm install -g @j0kz/smart-reviewer-mcp
npm install -g @j0kz/test-generator-mcp
npm install -g @j0kz/security-scanner-mcp
# ... etc

Then manually add to your editor's MCP config:

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

Editor-Specific Installation

# For specific editors
npx @j0kz/mcp-agents@latest cursor     # Cursor
npx @j0kz/mcp-agents@latest windsurf   # Windsurf
npx @j0kz/mcp-agents@latest vscode     # VS Code
npx @j0kz/mcp-agents@latest roo        # Roo Code

Configuration

Default Configuration

After installation, all tools are configured with sensible defaults:

  • Smart Reviewer: Moderate severity, includes metrics
  • Test Generator: Jest framework, 80% coverage target
  • Security Scanner: All vulnerability types enabled
  • Architecture Analyzer: Circular dependency detection on
  • API Designer: REST style, camelCase naming
  • DB Schema: PostgreSQL, 3NF normalization
  • Doc Generator: Standard JSDoc style
  • Refactor Assistant: All refactoring types enabled
  • Orchestrator: All workflows available

Custom Configuration

You can customize tool behavior by modifying your editor's MCP config file:

Claude Code: %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac)

Cursor: %APPDATA%\Cursor\User\settings.json (Windows) or ~/Library/Application Support/Cursor/User/settings.json (Mac)

Windsurf: %APPDATA%\Windsurf\User\settings.json (Windows) or ~/Library/Application Support/Windsurf/User/settings.json (Mac)

Example custom configuration:

{
  "mcpServers": {
    "smart-reviewer": {
      "command": "npx",
      "args": ["-y", "@j0kz/smart-reviewer-mcp"],
      "config": {
        "severity": "strict",
        "autoFix": true
      }
    }
  }
}

First Steps

1. Verify Installation

After installation, restart your editor and verify the tools are available:

  • Claude Code: Type / to see available MCP commands
  • Cursor/Windsurf: Check the MCP panel or use keyboard shortcuts
  • VS Code: Open command palette and search for "MCP"

2. Try Your First Tool

Let's start with a simple code review:

  1. Open a JavaScript/TypeScript file
  2. Use the Smart Reviewer tool:
    • Claude: Type /review-file <filepath>
    • Cursor: Select code and choose "Review with Smart Reviewer"
  3. Review the analysis results

3. Generate Tests

Generate tests for your code:

/generate-tests path/to/your/file.js

The tool will create comprehensive tests including:

  • Happy path scenarios
  • Edge cases
  • Error handling
  • Mock data

4. Security Scan

Run a security scan on your project:

/scan-project .

This will identify:

  • Hardcoded secrets
  • SQL injection vulnerabilities
  • XSS vulnerabilities
  • Dependency vulnerabilities

Common Workflows

Code Quality Workflow

  1. Write your code
  2. Run Smart Reviewer for instant feedback
  3. Apply suggested auto-fixes
  4. Generate tests with Test Generator
  5. Run Security Scanner before committing

API Development Workflow

  1. Design API with API Designer
  2. Generate OpenAPI spec
  3. Create mock server for testing
  4. Generate client SDKs
  5. Document with Doc Generator

Database Design Workflow

  1. Describe requirements in plain text
  2. Use DB Schema to generate schema
  3. Create migration files
  4. Generate ER diagrams
  5. Optimize with index suggestions

Troubleshooting

Tools Not Showing Up

  1. Restart your editor after installation
  2. Clear npm cache: npm cache clean --force
  3. Reinstall: npx @j0kz/mcp-agents@latest --force
  4. Check config file for syntax errors

Permission Errors

On macOS/Linux, you might need to use sudo:

sudo npx @j0kz/mcp-agents@latest

Version Conflicts

If you have old versions installed:

# Remove old versions
npm uninstall -g @j0kz/*-mcp

# Clean cache
npm cache clean --force

# Reinstall
npx @j0kz/mcp-agents@latest

Editor-Specific Issues

Claude Code:

  • Ensure you're using the desktop app, not web version
  • Check that MCP is enabled in settings

Cursor/Windsurf:

  • Update to the latest version
  • Check MCP extension is installed and enabled

VS Code:

  • Install the MCP extension from marketplace
  • Reload window after configuration changes

Getting Help

Next Steps

Now that you're set up, explore:

Happy coding! 🚀

Clone this wiki locally