TRAA MCP 服务器

TRAA MCP 服务器是一个基于模型上下文协议 (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]
   • 返回值: Image

3. save_snapshot

   • 将具有给定 ID 的屏幕源的快照保存到文件
   • 输入:
     • source_id: int
     • snapshot_size: tuple[int, int]
     • file_path: str
   • 返回值: None

示例

用法

配置 MCP 服务器

Claude Desktop 或其他 AI 代理

{
    "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(默认)

客户端

客户端提供了一个交互式命令行界面，可以轻松访问服务器功能：

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 文件。