MCP Unblocker Server

April 11, 2025 ยท View on GitHub

A Model Context Protocol (MCP) server that provides access to NetNut's Website Unblocker proxy service. This server enables you to bypass anti-bot systems and access blocked websites through configurable geo-location and HTML rendering options.

Features

  • Make requests through the unblocker proxy
  • Configurable geo-location (default: "us")
  • Optional HTML rendering
  • Secure credential handling through environment variables or command line arguments

Prerequisites

  • Node.js (v14 or higher)
  • npm or yarn

Installation

  1. Clone the repository:
git clone https://github.com/lololosys/Unblocker-MCP
cd mcp-unblocker
  1. Install dependencies:
npm install

Configuration

You can provide the unblocker credentials in two ways:

  1. Environment variables:
export UNBLOCKER_USERNAME="your-username"
export UNBLOCKER_PASSWORD="your-password"
export UNBLOCKER_SERVER_ADDR="Unblocker Proxy server address"
  1. Command line arguments:
node dist/index.js --username=your-username --password=your-password --serverAddr=unblocker-proxy-server-address:port

Usage

  1. Build the project:
npm run build
  1. Start the server:
npm run start

Making Requests

The server provides a single tool called unblocker-request with the following parameters:

  • url (required): The URL to fetch through the unblocker
  • country (optional, default: "us"): The country code for geo-location
  • render (optional, default: false): Whether to return rendered HTML

Example request:

{
  "url": "https://example.com",
  "country": "us",
  "render": false
}

Development

Project Structure

  • src/index.ts: Main server implementation
  • dist/: Compiled JavaScript output
  • package.json: Project dependencies and scripts
  • tsconfig.json: TypeScript configuration

Building

To compile the TypeScript code:

npm run build

Cursor

{
  "mcpServers": {
    "mcp-unblocker": {
      "command": "node",
      "args": [
        "dist/index.js",
        "--username=your-username",
        "--password=your-password",
        "--serverAddr=web-unblocker-server:port"
      ]
    }
  }
}

Example

make a request through the unblocker to https://ipinfo.io/json with country code spain with render true