MoussaabBadla/code-screenshot-mcp

> MCP server for generating beautiful code screenshots directly from Claude
Overview
A Model Context Protocol (MCP) server that enables Claude to generate syntax-highlighted code screenshots with professional themes. Supports direct file reading, line selection, git diff visualization, and batch processing.
Features
- **5 Professional Themes**: Dracula, Nord, Monokai, GitHub Light, GitHub Dark
- **File Integration**: Screenshot code directly from file paths with line range selection
- **Git Diff Support**: Visualize staged or unstaged changes
- **Batch Processing**: Process multiple files simultaneously
- **Auto Language Detection**: Supports 20+ programming languages
- **Native Claude Integration**: Works with Claude Desktop and Claude Code
Installation
Prerequisites
Configuration
**Quick Setup (Claude Code):**
**Manual Setup (Claude Desktop):**
Add to your Claude configuration file at ~/Library/Application Support/Claude/claude_desktop_config.json:
Restart Claude Desktop after configuration.
Development Setup
Quick Start
Basic Screenshot
From File
Specific Lines
Git Diff
Batch Processing
Available Themes
- dracula - Dark purple theme (default)
- nord - Arctic blue-tinted theme
- monokai - Classic dark theme
- github-light - Clean light theme
- github-dark - GitHub's dark theme
API Reference
generate_code_screenshot
Generate a screenshot from code string.
**Parameters:**
- code (string, required) - Source code to screenshot
- language (string, required) - Programming language identifier
- theme (string, optional) - Color theme (default: "dracula")
**Returns:** PNG image with base64 encoding
screenshot_from_file
Screenshot code from file path with automatic language detection.
**Parameters:**
- filePath (string, required) - Path to source file
- startLine (number, optional) - Start line number (1-indexed)
- endLine (number, optional) - End line number
- theme (string, optional) - Color theme (default: "dracula")
**Supported Extensions:**
.js, .jsx, .ts, .tsx, .py, .rb, .go, .rs, .java, .c, .cpp, .cs, .php, .swift, .kt, .sql, .sh, .yml, .yaml, .json, .xml, .html, .css, .scss, .md
**Returns:** PNG image with base64 encoding
screenshot_git_diff
Generate screenshot of git diff output.
**Parameters:**
- filePath (string, optional) - Specific file to diff (shows all if omitted)
- staged (boolean, optional) - Show staged changes instead of unstaged
- theme (string, optional) - Color theme (default: "dracula")
**Returns:** PNG image with base64 encoding
batch_screenshot
Process multiple files in a single operation.
**Parameters:**
- filePaths (string[], required) - Array of file paths