RedEye MCP ServerDocs
Access Control Notice

This RedEye MCP Server instance is protected and restricted to authorized MCP clients only. Direct web access is limited to prevent unauthorized usage. Access is granted to:

  • Localhost/development environments
  • MCP clients (Claude Desktop, etc.)
  • Requests with valid authentication tokens

Overview

RedEye MCP Server is a Model Context Protocol server that provides real-time website screenshot capabilities. It's the only website snapshot generator to stream screenshots as soon as you request them.

Real-time

Instant screenshot delivery

MCP Native

Built for AI integration

Scalable

Production-ready architecture

Installation

NPM Installation (Recommended)
Install RedEye MCP Server globally via npm

1. Install from NPM

# Install globally
npm install -g @redeye/mcp-server

# Or install locally in your project
npm install @redeye/mcp-server

2. Start the MCP Server

# If installed globally
redeye-mcp-server

# If installed locally
npx @redeye/mcp-server
Manual Installation
Build from source for development

1. Clone and Install

git clone https://github.com/redeye-team/redeye-mcp-server.git
cd redeye-mcp-server
npm install

2. Build and Start

npm run build
npm start

MCP Tools

RedEye exposes the following tools through the Model Context Protocol:

takeScreenshot
Capture a screenshot of any website
Parameters:
  • url (string) - Website URL to capture
  • width (number, optional) - Viewport width (default: 1200)
  • height (number, optional) - Viewport height (default: 800)
  • fullPage (boolean, optional) - Capture full page (default: false)
  • device (string, optional) - Device emulation (desktop/mobile/tablet)
{
  "url": "https://example.com",
  "width": 1200,
  "height": 800,
  "fullPage": true,
  "device": "desktop"
}
batchCapture
Capture multiple screenshots in parallel
Parameters:
  • urls (array) - Array of URLs to capture
  • options (object, optional) - Default options for all captures
analyzePage
Analyze page performance and metadata

Returns page load times, resource counts, and metadata along with screenshot.

prefetch
Pre-warm cache for faster subsequent captures

Loads the page in background to improve screenshot capture speed.

MCP Resources

Access screenshots and job status through these resource endpoints:

/screenshot/{url}
Get cached screenshot for a URL
/screenshot/{url}/fullpage
Get full-page screenshot for a URL
/jobs/{jobId}
Get status and results of batch jobs

Configuration

Environment Variables
Configure your RedEye MCP Server
REDEYE_AUTH_TOKEN

Authentication token for API access (optional)

REDEYE_API_KEY

API key for programmatic access (optional)

MCP_SECRET_KEY

Secret key for MCP server authentication

BROWSER_POOL_SIZE

Number of browser instances (default: 3)

CACHE_TTL

Cache time-to-live in seconds (default: 3600)

MAX_CONCURRENT_JOBS

Maximum concurrent screenshot jobs (default: 10)

Security Configuration
Configure access control and security settings
Access Control

The server automatically restricts access based on:

  • Request origin (localhost allowed)
  • User-Agent detection (MCP clients allowed)
  • Authentication headers (if configured)
Optional Authentication

For additional security, set environment variables:

REDEYE_AUTH_TOKEN=your-secret-token
REDEYE_API_KEY=your-api-key

Testing

MCP Inspector
Test your server with the official MCP Inspector
npx @modelcontextprotocol/inspector node dist/server.js

This will open a web interface where you can test all MCP tools and resources.

Claude Desktop Integration

Connect to Claude Desktop
Use RedEye with Claude for AI-powered screenshot workflows
Option 1: NPM Installation (Recommended)

If you installed via npm, add this to your Claude Desktop config:

{
  "mcpServers": {
    "redeye": {
      "command": "npx",
      "args": ["@redeye/mcp-server"]
    }
  }
}
Option 2: Global Installation

If you installed globally, use this configuration:

{
  "mcpServers": {
    "redeye": {
      "command": "redeye-mcp-server"
    }
  }
}
Option 3: Local Development

For local development builds:

{
  "mcpServers": {
    "redeye": {
      "command": "node",
      "args": ["/absolute/path/to/redeye-mcp-server/dist/server.js"]
    }
  }
}

Note: Replace /absolute/path/to/redeye-mcp-server/ with your actual installation path.

✅ Live Demo Available

Test the RedEye MCP Server functionality at: https://redeye-mcp.vercel.app

The web demo shows the same screenshot capabilities that will be available through MCP.

Getting Started
  1. Add the configuration to your Claude Desktop config file
  2. Restart Claude Desktop to load the MCP server
  3. Ask Claude: "Take a screenshot of https://example.com"
  4. Enjoy real-time website screenshots in your AI conversations!