A
securityA
licenseA
qualityModel Context Protocol server for fetching web content and processing images. This allows Claude Desktop (or any MCP client) to fetch web content and handle images appropriately.
Last updated -
1
5,341
30
MIT License
Enables screenshot capture functionality on macOS, allowing full desktop screenshots, specific window captures, custom area selection, and screenshot management through the built-in screencapture command.
Screenshot MCP Server
A Model Context Protocol (MCP) server that enables natural language screenshot capture on macOS using FastMCP.
Features
Full Desktop Screenshots: Capture the entire desktop with optional delay
Window Screenshots: Interactive window selection for capturing specific applications
Area Screenshots: Interactive area selection for capturing custom regions
Screenshot Management: List and manage saved screenshots
Automatic Organization: Screenshots saved to
~/Desktop/mcp-screenshots/
Installation
Clone the repository:
git clone https://github.com/your-username/screenshot-mcp.git
cd screenshot-mcp
Create and activate a virtual environment:
python3 -m venv venv
source venv/bin/activate # On macOS/Linux
Install dependencies:
pip install -r requirements.txt
Testing
Run the test script to verify everything is working:
python test_server.py
Configuration
Add the following to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"screenshot": {
"command": "/path/to/screenshot-mcp/venv/bin/python",
"args": ["/path/to/screenshot-mcp/server.py"],
"env": {}
}
}
}
Replace /path/to/screenshot-mcp with the actual path to your cloned repository.
Available Tools
screenshot
Captures a screenshot of the entire desktop.
Parameters:
filename(optional): Custom filename for the screenshotdelay(optional): Delay in seconds before capturing (default: 0)
screenshot_window
Captures a screenshot of a specific window through interactive selection.
Parameters:
filename(optional): Custom filename for the screenshot
screenshot_area
Captures a screenshot of a selected area through interactive selection.
Parameters:
filename(optional): Custom filename for the screenshot
list_screenshots
Lists recently saved screenshots with details.
Parameters:
limit(optional): Maximum number of screenshots to list (default: 10)
Usage Examples
Once configured in Claude Desktop, you can use natural language commands like:
"Take a screenshot"
"Capture a screenshot with 3 second delay"
"Take a screenshot of this window"
"Screenshot just this area"
"Show me my recent screenshots"
Requirements
macOS (uses built-in
screencapturecommand)Python 3.8+
Claude Desktop application
File Structure
screenshot-mcp/
├── server.py # Main MCP server implementation
├── test_server.py # Test script for verification
├── requirements.txt # Python dependencies
├── README.md # This file
└── .gitignore # Git ignore rules
Troubleshooting
Permission Issues: macOS may require screen recording permissions for the application running the server
Path Issues: Ensure the paths in the Claude Desktop configuration are absolute and correct
Virtual Environment: Make sure to use the Python interpreter from your virtual environment
License
This project is open source. Feel free to modify and distribute as needed.
This server cannot be installed
A Model Context Protocol server that enables natural language-driven screenshot capture on macOS, allowing users to take full desktop screenshots, capture specific windows, or select custom screen areas through Claude Desktop.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that provides AI vision capabilities for analyzing UI screenshots, offering tools for screen analysis, file operations, and UI/UX report generation.
- AsecurityAlicenseAqualityModel Context Protocol server that enables Claude Desktop (or any MCP client) to fetch web content and process images appropriately.Last updated -1106MIT License
- AsecurityFlicenseAqualityA lightweight Model Context Protocol (MCP) server that enables your LLM to capture screenshots of any specified URL and return only the access URL for the captured image. This tool simplifies the process of generating and sharing webpage snapshots, making it perfect for integrating visual capture caLast updated -11