TRAA MCP Server logo

TRAA MCP Server

by opentraa

TRAA MCP Server is a screen capture server based on the Model Context Protocol (MCP). It provides functionality for enumerating system screens and windows, as well as capturing screenshots.

View on GitHub

Last updated: N/A

What is TRAA MCP Server?

TRAA MCP Server is a server that allows you to enumerate available screens and windows and capture screenshots of them. It uses the Model Context Protocol (MCP) for communication and supports stdio and Server-Sent Events (SSE) transport methods.

How to use TRAA MCP Server?

To use the server, you need to configure it with the correct command and arguments. You can run it in stdio or SSE mode. The client provides an interactive command-line interface to access the server functionality, allowing you to list screen sources, create snapshots, and save snapshots to files.

Key features of TRAA MCP Server

  • Screen and Window Source Enumeration (list displays and windows with ID, title, type, and position)

  • Screen Capture (capture screenshots of any display or window)

  • Customizable screenshot dimensions

  • Support for both JPEG and PNG formats with configurable quality

Use cases of TRAA MCP Server

  • Automated screenshot capture for testing

  • Remote screen monitoring

  • Integration with AI agents for visual context

  • Creating visual documentation

FAQ from TRAA MCP Server

What image formats are supported?

The server supports JPEG and PNG formats. JPEG is best for screenshots with many colors, while PNG is better for text or sharp edges.

How do I configure the server?

You can configure the server using a JSON configuration file, specifying the command and arguments for running the server.

What are the dependencies?

The server requires Python >= 3.10, mcp >= 1.0.0, anyio >= 4.5, traa >= 0.1.5, and pillow >= 11.1.0.

How do I run the server in SSE mode?

Use the command uv run traa_mcp_server-sse --port 3001 (or specify a different port).

How do I use the client?

Run uv run traa_mcp_client and follow the instructions in the command-line interface to use the available tools.