Traa Mcp

What is Traa Mcp?

Traa Mcp is a screen capture server based on the Model Context Protocol (MCP). It enumerates system screens and windows and captures screenshots, communicating with clients via stdio or SSE transport. It is designed for use with MCP-compatible AI agents like Claude Desktop.

How to use Traa Mcp?

Configure the server in your MCP client (e.g., Claude Desktop) by adding a JSON entry with the uv command pointing to the traa_mcp_server module. Alternatively, run the server directly in stdio mode (uv run traa_mcp_server) or SSE mode with a specific port (uv run traa_mcp_server-sse --port 3001). A client-side CLI is also available (uv run traa_mcp_client) for interactive tool access.

Key features of Traa Mcp

• Enumerate all available system displays and windows.
• Capture screenshots of any display or window.
• Customizable screenshot dimensions and image quality.
• Supports JPEG and PNG image formats.
• Automatic directory creation when saving screenshots.

Use cases of Traa Mcp

• List all screens and windows in a system.
• Capture a screenshot of a specific display or window.
• Save a screenshot directly to a file with configurable format and quality.

FAQ from Traa Mcp

What are the runtime dependencies of Traa Mcp?

Python 3.10 or later, along with packages mcp >= 1.0.0, anyio >= 4.5, traa >= 0.1.5, and pillow >= 11.1.0.

What transport methods does Traa Mcp support?

It supports both standard input/output (stdio) and Server-Sent Events (SSE) transport.

What image formats are available for screenshots?

JPEG and PNG. JPEG is best for colorful content with smaller file sizes; PNG is lossless and supports transparency.

What is the default image quality setting?

JPEG quality is set to 60 by default to keep file sizes under 1 MB for MCP model compatibility.

Can Traa Mcp capture both displays and individual windows?

Yes, it enumerates and captures both display screens and application windows.