MCP Server Configuration

Learn how to configure the Renamify MCP Server for different AI assistants and customize its behavior.

Basic Configuration

The minimal configuration for any MCP client:

{
  "mcpServers": {
    "renamify": {
      "command": "npx",
      "args": ["-y", "@renamify/mcp-server"]
    }
  }
}

Advanced Configuration Options

Custom Renamify Binary Path

If renamify is not in your PATH, you can specify a custom location:

{
  "mcpServers": {
    "renamify": {
      "command": "npx",
      "args": ["-y", "@renamify/mcp-server"],
      "env": {
        "RENAMIFY_PATH": "/custom/path/to/renamify"
      }
    }
  }
}

Working Directory

Specify a default working directory for renaming operations:

{
  "mcpServers": {
    "renamify": {
      "command": "npx",
      "args": ["-y", "@renamify/mcp-server"],
      "cwd": "/path/to/your/project"
    }
  }
}

Logging and Debugging

Enable debug logging for troubleshooting:

{
  "mcpServers": {
    "renamify": {
      "command": "npx",
      "args": ["-y", "@renamify/mcp-server"],
      "env": {
        "DEBUG": "renamify:*",
        "LOG_LEVEL": "debug"
      }
    }
  }
}

Client-Specific Configurations

Claude Desktop

Claude Desktop

Location: Platform-specific configuration file

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

Full configuration example:

{
  "mcpServers": {
    "renamify": {
      "command": "npx",
      "args": ["-y", "@renamify/mcp-server"],
      "env": {
        "RENAMIFY_PATH": "/usr/local/bin/renamify"
      }
    }
  }
}

Cursor

Cursor

Location: Cursor settings file

• Access via: Settings → Features → MCP → Edit Configuration

{
  "mcp": {
    "servers": {
      "renamify": {
        "command": "npx",
        "args": ["-y", "@renamify/mcp-server"],
        "enabled": true
      }
    }
  }
}

Continue

Continue

Location: ~/.continue/config.json

{
  "models": [...],
  "mcpServers": [
    {
      "name": "renamify",
      "command": "npx",
      "args": ["-y", "@renamify/mcp-server"],
      "description": "Smart case-aware renaming"
    }
  ]
}

VS Code Extension

VS Code with MCP Extension

If using a generic MCP extension for VS Code:

1. Install an MCP client extension
2. Open VS Code settings (Cmd/Ctrl + ,)
3. Search for MCP configuration
4. Add server configuration:

{
  "mcp.servers": {
    "renamify": {
      "command": "npx",
      "args": ["-y", "@renamify/mcp-server"]
    }
  }
}

Environment Variables

The MCP Server respects these environment variables:

RENAMIFY_PATH

• Type: String
• Default: renamify (searches PATH)
• Description: Path to the renamify binary

DEBUG

• Type: String
• Default: (none)
• Description: Enable debug output with renamify:*

LOG_LEVEL

• Type: String
• Default: info
• Description: Logging level: error, warn, info, debug

NO_COLOR

• Type: Boolean
• Default: false
• Description: Disable colored output

Default Tool Behaviors

You can configure default behaviors for the MCP tools:

Default Preview Format

The MCP Server defaults to summary format for AI agents. To change:

{
  "env": {
    "RENAMIFY_DEFAULT_PREVIEW": "table"  // or "diff", "json"
  }
}

Auto-commit Behavior

To always create git commits after applying changes:

{
  "env": {
    "RENAMIFY_AUTO_COMMIT": "true"
  }
}

Dry Run by Default

For extra safety, make all operations dry-run by default:

{
  "env": {
    "RENAMIFY_DEFAULT_DRY_RUN": "true"
  }
}

Project-Specific Configuration

You can create a .renamify/config.json file in your project root:

{
  "defaults": {
    "styles": ["snake", "camel", "pascal", "kebab"],
    "excludes": [
      "node_modules/**",
      "dist/**",
      "build/**",
      ".git/**"
    ],
    "renameFiles": true,
    "renameDirs": true,
    "atomic": true
  },
  "mcp": {
    "preview": "summary",
    "autoCommit": false,
    "commitMessage": "renamify: {old} → {new}"
  }
}

Multiple Projects Configuration

Configure different settings for different projects:

{
  "mcpServers": {
    "renamify-project1": {
      "command": "npx",
      "args": ["-y", "@renamify/mcp-server"],
      "cwd": "/path/to/project1",
      "env": {
        "RENAMIFY_AUTO_COMMIT": "true"
      }
    },
    "renamify-project2": {
      "command": "npx",
      "args": ["-y", "@renamify/mcp-server"],
      "cwd": "/path/to/project2",
      "env": {
        "RENAMIFY_DEFAULT_DRY_RUN": "true"
      }
    }
  }
}

Performance Tuning

Memory Limits

For large codebases, increase Node.js memory limit:

{
  "env": {
    "NODE_OPTIONS": "--max-old-space-size=4096"
  }
}

Parallel Processing

Enable parallel file processing:

{
  "env": {
    "RENAMIFY_PARALLEL": "true",
    "RENAMIFY_WORKERS": "4"
  }
}

Security Considerations

Restricted Mode

Limit renaming to specific directories:

{
  "env": {
    "RENAMIFY_ALLOWED_PATHS": "/home/user/projects,/home/user/work",
    "RENAMIFY_RESTRICT_MODE": "true"
  }
}

Read-Only Mode

Enable read-only mode for planning without applying:

{
  "env": {
    "RENAMIFY_READ_ONLY": "true"
  }
}

Troubleshooting Configuration

Verify Configuration

Test your configuration with a simple request to your AI assistant:

“Can you list the available Renamify tools?”

The assistant should respond with the 7 available tools.

Debug Mode

Enable comprehensive debugging:

{
  "env": {
    "DEBUG": "*",
    "LOG_LEVEL": "debug",
    "RENAMIFY_VERBOSE": "true"
  }
}

Common Issues

Tools not appearing:

• Check JSON syntax is valid
• Ensure paths use forward slashes (even on Windows)
• Restart your AI assistant after changes

Permission errors:

• Ensure the renamify binary is executable
• Check file system permissions for your project

Binary not found:

• Use absolute paths in RENAMIFY_PATH
• Verify the binary exists at the specified location

Configuration Templates

Development Environment

{
  "mcpServers": {
    "renamify-dev": {
      "command": "npx",
      "args": ["-y", "@renamify/mcp-server"],
      "env": {
        "LOG_LEVEL": "debug",
        "RENAMIFY_DEFAULT_DRY_RUN": "true",
        "RENAMIFY_AUTO_COMMIT": "false"
      }
    }
  }
}

Production Environment

{
  "mcpServers": {
    "renamify-prod": {
      "command": "renamify-mcp",
      "env": {
        "LOG_LEVEL": "error",
        "RENAMIFY_AUTO_COMMIT": "true",
        "RENAMIFY_RESTRICT_MODE": "true",
        "RENAMIFY_ALLOWED_PATHS": "/var/www/app"
      }
    }
  }
}

CI/CD Environment

{
  "mcpServers": {
    "renamify-ci": {
      "command": "npx",
      "args": ["-y", "@renamify/mcp-server"],
      "env": {
        "RENAMIFY_READ_ONLY": "true",
        "RENAMIFY_DEFAULT_PREVIEW": "json",
        "CI": "true"
      }
    }
  }
}

Next Steps

Tools Reference

Detailed documentation for each MCP tool

Usage Examples

Real-world renaming scenarios

AI Agent Guide

Best practices for AI-assisted renaming