What is Traa Mcp

TRAA MCP is a screen capture server based on the Model Context Protocol (MCP) that enables enumeration of system screens and windows, as well as capturing screenshots.

Use cases

Use cases include creating automated testing scripts that capture application screens, developing tools for remote support that require screen sharing, and generating documentation with visual content from software applications.

How to use

To use TRAA MCP, configure the MCP server with the appropriate command and arguments in your application. Utilize the provided tools to enumerate screen sources, create snapshots, and save them to files.

Key features

Key features include screen and window source enumeration, customizable screenshot dimensions, support for JPEG and PNG formats, configurable image quality settings, and automatic directory creation for saving files.

Where to use

TRAA MCP can be used in various fields such as software development, automated testing, remote monitoring, and any application requiring screen capture functionality.

TRAA MCP Server

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. The server communicates with clients through the MCP protocol, supporting both standard input/output (stdio) and Server-Sent Events (SSE) transport methods.

Features

• Screen and Window Source Enumeration

  • List all available displays in the system
  • List all available windows in the system
  • Each source includes ID, title, type (display/window), and position information

• Screen Capture

  • Capture screenshots of any display or window
  • Customizable screenshot dimensions
  • Support for both JPEG and PNG formats
  • Configurable image quality settings
  • Automatic directory creation for saving files

Tools

1. enum_screen_sources

   • Enumerate all screen and window sources available on the system and return a list of SimpleScreenSourceInfo
   • Returns: list[SimpleScreenSourceInfo]

2. create_snapshot

   • Create a snapshot of the screen source with the given ID and return it as an image
   • Inputs:
     • source_id: int
     • snapshot_size: tuple[int, int]
   • Returns: Image

3. save_snapshot

   • Save a snapshot of the screen source with the given ID to a file
   • Inputs:
     • source_id: int
     • snapshot_size: tuple[int, int]
     • file_path: str
   • Returns: None

Example

Usage

Configure MCP Servers

Claude Desktop or other AI agents

{
  "mcpServers": {
    "traa_mcp": {
      "command": "absolute/path/to/uv",
      "args": [
        "--directory",
        "absolute/path/to/traa-mcp",
        "run",
        "traa_mcp_server"
      ]
    }
  }
}

Server Side

The server supports two running modes:

1. stdio mode (default):

uv run traa_mcp_server

2. SSE mode (with port specification):

uv run traa_mcp_server-sse --port 3001(default)

Client Side

The client provides an interactive command-line interface for easy access to server functionality:

uv run traa_mcp_client

After starting, the client displays a list of all available tools. You can:

1. Use enum_screen_sources to view all available screen and window sources
2. Use create_snapshot to capture screenshots and get image data
3. Use save_snapshot to save screenshots directly to files

Image Format Support

• JPEG Format

  • Best for screenshots with many colors
  • Smaller file size
  • Quality setting available (1-100)
  • Automatically converts to RGB color space

• PNG Format

  • Best for screenshots with text or sharp edges
  • Lossless compression
  • Supports transparency (RGBA)
  • Larger file size but better quality

Dependencies

• Python >= 3.10
• mcp >= 1.0.0
• anyio >= 4.5
• traa >= 0.1.5
• pillow >= 11.1.0 (for image processing)

Notes

• For MCP model compatibility, JPEG format with quality=60 is used by default to keep file sizes under 1MB
• When saving files, parent directories are automatically created if they don’t exist
• Error handling includes detailed messages for easier troubleshooting

License

See the LICENSE file for details.