abhi5h3k_mcp_url2snap

abhi5h3k_mcp_url2snap

by Abhi5h3k
A lightweight MCP server that captures URL screenshots and returns access URLs for integration with AI applications.

URL Screenshot Capture for AI Applications

Overview

The MCP-URL2SNAP is a lightweight Model Context Protocol (MCP) server designed to enable AI models to capture screenshots of any specified URL and return the access URL for the captured image. This tool simplifies the process of generating and sharing webpage snapshots, making it ideal for integrating visual capture capabilities into AI applications like Claude Desktop or automation workflows.

What is Model Context Protocol (MCP)?

MCP is a standardized protocol that streamlines communication between AI models and external systems. It acts as a universal language, allowing different AI agents, tools, and services to interact seamlessly.

MCP Architecture

Features

  • Email Verification: Verify email addresses in real-time.
  • MCP Integration: Seamlessly connect with MCP-compatible LLMs.
  • Easy Setup: Built with Python and the MCP SDK for quick deployment.

MCP Client-Server Architecture

MCP follows a client-server architecture, enabling efficient communication between AI models and external services.

Client-Server Architecture

Watch the Demo

Click the image below to watch a video demo of the MCP Email Verify tool in action:

Youtube Demo

Requirements

  • Python: Python 3.11.0 or higher.
  • UV: 0.6.9 or higher.

Setup

1. Clone the Repository

git clone https://github.com/Abhi5h3k/MCP-URL2SNAP.git
cd MCP-URL2SNAP

2. Install UV

If you don’t have UV installed, use the following commands:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Verify the installation:

uv --version

3. Set Up the Virtual Environment

Create a virtual environment using UV:

uv venv

Activate the virtual environment:
- Windows:

.venv\Scripts\activate

4. Install Dependencies

Install the required dependencies from pyproject.toml using UV:

uv install

Running the Server

1. Set Up Environment Variables

Create a .env file in the root directory and add your AbstractAPI key:

ABSTRACT_API_KEY=your_api_key_here

2. Run the Server

Start the MCP server:

uv run server.py

Usage

1. Register the Server with Claude Desktop

Update the claude_desktop_config.json file to include your MCP server:

{
    "mcpServers": {
        "verify_mail": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\ABSOLUTE\\PATH\\TO\\MCP-Email-Verify",
                "run",
                "server.py"
            ],
            "env": {
                "ABSTRACT_API_KEY": "YOUR_API_KEY"
            }
        }
    }
}

2. Restart Claude Desktop

Restart Claude Desktop to detect the new tool.

3. Verify Emails

Use prompts like:

"can you show me the screenshot of https://github.com/Abhi5h3k"

Development

Formatting and Linting

This project uses black and isort for code formatting and import sorting.

  1. Install development dependencies:
uv add black isort --dev
  1. Format the code:
black .
  1. Sort imports:
isort .

Set Up Pre-Commit

pre-commit install
pre-commit run --all-files

About

Demo MCP tool to capture URL screenshots.

Resources

Stars

1 star

Watchers

1 watching

Forks

0 forks

Languages

Features & Capabilities

Categories
mcp_server model_context_protocol python screenshot api_integration claude

Implementation Details

Stats

0 Views
1 GitHub Stars

Repository Info

Abhi5h3k Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
21423
9300