Skip to main content
Glama
MCP Screen Text
by ikhide

MCP Screen Text

A Model Context Protocol (MCP) server that provides screen capture and optical character recognition (OCR) capabilities.

🎥 Demo Video

MCP Screen Text Demo

See MCP Screen Text in action - capturing screens and extracting text with Claude Desktop

Related MCP server: screenshot-mcp

Features

  • Screen Capture: Take screenshots of specific displays or applications

  • Application-Specific Screenshots: Capture screenshots of specific application windows

  • OCR Text Extraction: Extract text from screenshots or existing images

  • Desktop Storage: All screenshots are saved to a "Screenshots" folder on your Desktop

  • Multi-format Support: Support for PNG and JPG image formats

  • Multi-language OCR: Support for multiple languages in text recognition

  • Application Discovery: List running applications available for capture

Tools Available

capture_screen

Captures a screenshot of the entire screen or a specific display.

Parameters:

  • display (number, optional): Display number to capture (0 for primary display)

  • format (string, optional): Image format for the screenshot ('png' or 'jpg')

capture_application_screen

Captures a screenshot of a specific application window.

Parameters:

  • applicationName (string, required): Name of the application to capture (e.g., 'Safari', 'Chrome', 'Finder')

  • format (string, optional): Image format ('png' or 'jpg')

list_applications

Lists all running applications that can be captured.

Parameters: None

extract_text

Extracts text from an existing image file using OCR.

Parameters:

  • imagePath (string, required): Path to the image file

  • language (string, optional): Language for OCR recognition (e.g., "eng", "spa", "fra")

capture_screen_and_extract_text

Captures a screenshot and extracts text from it in one operation. This is a convenience tool that combines screen capture and OCR and can work with both full screen and application-specific capture.

Parameters:

  • display (number, optional): Display number to capture (0 for primary display) - ignored if applicationName is provided

  • language (string, optional): Language for OCR recognition (e.g., "eng", "spa", "fra")

  • applicationName (string, optional): Name of the application to capture (e.g., 'Safari', 'Chrome'). If provided, captures only this application's window instead of full screen.

Installation

npm install

Development

# Build the project
npm run build

# Run in development mode
npm run dev

# Run the built version
npm start

Dependencies

  • @modelcontextprotocol/sdk: MCP SDK for server implementation

  • screenshot-desktop: Cross-platform screenshot capture

  • sharp: High-performance image processing

  • tesseract.js: OCR text extraction

Usage with MCP Client

This server can be used with any MCP-compatible client. Configure your client to connect to this server using stdio transport.

Example configuration for Claude Desktop:

{
  "mcpServers": {
    "screen-text": {
      "command": "node",
      "args": ["path/to/mcp-screen-text/dist/index.js"]
    }
  }
}

License

ISC

Available Tools

5 tools
capture_application_screenC

Captures a screenshot of a specific application window

Inputs: applicationName (required), format.

capture_screenC

Captures a screenshot of the specified display

Inputs: display, format.

capture_screen_and_extract_textA

Captures a screenshot and extracts text from it in one operation. Can capture full screen or a specific application window.

Inputs: display, language, applicationName.

extract_textC

Extracts text from an image using OCR

Inputs: imagePath (required), language.

list_applicationsB

Lists all running applications that can be captured

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 5 tools

    Disambiguation2/5

    Multiple tools have overlapping purposes that could cause confusion. For example, capture_application_screen and capture_screen_and_extract_text both handle application window screenshots, while capture_screen and capture_screen_and_extract_text both handle full-screen captures. The descriptions help somewhat, but the boundaries between tools are unclear, especially for agents trying to choose between similar options.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with clear verb_noun structures (e.g., capture_screen, extract_text, list_applications). There are no deviations in naming style, making the set predictable and easy to parse programmatically.

    Tool Count4/5

    With 5 tools, the count is well-scoped for a screen text capture domain, though it feels slightly thin. Each tool appears to serve a purpose, but the overlap suggests some tools could be consolidated, making the count borderline but still reasonable for the server's functionality.

    Completeness3/5

    The tool set covers core operations like capturing screens, extracting text, and listing applications, but there are notable gaps. For instance, there's no way to manage or delete captured images, and the OCR functionality is split across tools without clear update or configuration options, which could lead to agent workarounds for full lifecycle handling.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers