Lens

by bysages

3 stars
172 downloads
Not rated
GitHub Website

About

A high-performance image proxy and web services toolkit built with modern TypeScript. Lens provides a comprehensive suite of web utilities including image processing, screenshot capture, font serving, and more.

Details

Author
bysages
GitHub stars
3
Downloads
172
Categories
Other

- Image proxy with IPX-powered resize, format conversion, and optimization
- Website screenshot capture with Playwright-aligned options and caching
- Article content extraction (Markdown/HTML) via the Reader service
- Google Fonts compatible API (v1 and v2) with variable font support
- Dynamic Open Graph image generation
- Smart favicon extraction from multiple sources with fallback
- Cached Gravatar avatar proxy supporting email or hash input

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Lens
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, install dependencies with pnpm, copy .env.example to .env, and run pnpm dev to start the development server on http://localhost:3000. For MCP server use, configure Claude Desktop with the URL https://api.bysages.com/mcp in claude_desktop_config.json.

reader

Extract article content from a URL as Markdown (default) or cleaned HTML. Returns title, content, and metadata.

screenshot

Capture a screenshot of a website. Returns a base64-encoded image.

favicon

Extract the favicon of a website. Returns a base64-encoded PNG image.

og

Generate a dynamic Open Graph image with custom title, description, and styling.

gravatar

Get a Gravatar avatar by email or MD5 hash. Returns a base64-encoded image.

img

Transform and optimize an image (resize, crop, format convert, quality adjust). Returns a base64-encoded image.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "lens": {
            "lens": {
                "url": "https://api.bysages.com/mcp"
            }
        }
    }
}

McpServers

{
    "lens": {
        "url": "https://api.bysages.com/mcp"
    }
}

Lens

GitHub
GitHub Actions
Contributor Covenant

> A high-performance image proxy and web services toolkit built with modern TypeScript. Lens provides a comprehensive suite of web utilities including image processing, screenshot capture, font serving, and more.

🚀 Features

Core Services

- 🖼️ Image Proxy: IPX-powered image processing with resize, format conversion, optimization
- 📸 Screenshot Capture: Fast website screenshot service with resource optimization
- 📄 Reader: Article content extraction (Markdown/HTML) with Readability
- 🅰️ Font Service: Google Fonts compatible API with multiple providers
- 🎨 Open Graph Images: Dynamic OG image generation
- 🎯 Favicon Extraction: Smart favicon extraction from websites
- 👤 Gravatar Proxy: Cached Gravatar avatar proxy with email or hash input
- 🤖 MCP Server: Model Context Protocol server exposing all services as tools via JSON-RPC 2.0

Performance & Scalability

- ⚡ Redis Caching: Redis-powered caching with 24-hour intelligent caching
- 🚀 Resource Optimization: Optimized page loading with blocked unnecessary resources
- 🛡️ Rate Limiting: Rate limiting for expensive operations
- 🔄 Graceful Degradation: Automatic fallbacks for missing services

📦 Quick Start

Prerequisites

- Node.js 22+
- pnpm 10+ (recommended) or npm

Installation

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.