Traa Mcp

TRAA MCP Server

TRAA MCP Server 是一款基于 Model Context Protocol（MCP）的屏幕捕获服务。它提供枚举系统屏幕和窗口以及截取屏幕截图的功能。该服务通过 MCP 协议与客户端通信，支持标准输入/输出（stdio）和服务器发送事件（SSE）两种传输方式。

功能

• 屏幕和窗口来源枚举

  • 列出系统中所有可用的显示器
  • 列出系统中所有可用的窗口
  • 每个来源都包含 ID、标题、类型（显示器/窗口）和位置信息

• 屏幕捕获

  • 捕获任意显示器或窗口的屏幕截图
  • 可自定义屏幕截图尺寸
  • 支持 JPEG 和 PNG 格式
  • 可配置图像质量设置
  • 保存文件时自动创建目录

工具

1. enum_screen_sources

   • 枚举系统中所有可用的屏幕和窗口来源，并返回 SimpleScreenSourceInfo 列表
   • 返回：list[SimpleScreenSourceInfo]

2. create_snapshot

   • 截取指定 ID 的屏幕来源，并以图像形式返回
   • 输入：
     • source_id: int
     • snapshot_size: tuple[int, int]
   • 返回：图像

3. save_snapshot

   • 将指定 ID 的屏幕来源截图保存到文件
   • 输入：
     • source_id: int
     • snapshot_size: tuple[int, int]
     • file_path: str
   • 返回：None

示例

使用方法

配置 MCP 服务

Claude Desktop 或其他 AI Agent

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

服务端

该服务支持两种运行模式：

1. stdio 模式（默认）：

uv run traa_mcp_server

2. SSE 模式（指定端口）：

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

客户端

客户端提供交互式命令行界面，方便使用服务功能：

uv run traa_mcp_client

启动后，客户端会显示所有可用工具的列表。你可以：

1. 使用 enum_screen_sources 查看所有可用的屏幕和窗口来源
2. 使用 create_snapshot 截取屏幕截图并获取图像数据
3. 使用 save_snapshot 将屏幕截图直接保存到文件

图像格式支持

• JPEG 格式

  • 最适合包含多种颜色的屏幕截图
  • 文件较小
  • 可设置质量（1-100）
  • 自动转换为 RGB 色彩空间

• PNG 格式

  • 最适合包含文字或锐利边缘的屏幕截图
  • 无损压缩
  • 支持透明度（RGBA）
  • 文件较大，但质量更好

依赖项

• Python >= 3.10
• mcp >= 1.0.0
• anyio >= 4.5
• traa >= 0.1.5
• pillow >= 11.1.0（用于图像处理）

备注

• 为兼容 MCP 模型，默认使用质量为 60 的 JPEG 格式，以将文件大小控制在 1MB 以下
• 保存文件时，如果父目录不存在，则会自动创建
• 错误处理会提供详细信息，便于排查问题

许可证

详情请参阅 LICENSE 文件。