Traa MCP

🚀 TRAA MCP 服務器

TRAA MCP 服務器是一款基於模型上下文協議（MCP）的屏幕捕獲服務器。它具備枚舉系統屏幕和窗口，以及捕獲屏幕截圖的功能。該服務器通過 MCP 協議與客戶端通信，支持標準輸入輸出（stdio）和 Server-Sent Events (SSE) 兩種傳輸方式。

🚀 快速開始

配置 MCP 服務器

在 Claude Desktop 或其他 AI 代理中配置：

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

服務端運行

服務器支持兩種運行模式：

1. 標準輸入輸出模式（默認）：

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 保存指定源的屏幕截圖

✨ 主要特性

• 屏幕和窗口源枚舉：
  • 列出系統中所有可用的顯示設備。
  • 列出系統中所有可用的窗口。
  • 每個源包括 ID、標題、類型（顯示/窗口）以及位置信息。
• 屏幕捕獲：
  • 捕獲指定顯示設備或窗口的屏幕截圖。
  • 自定義截圖尺寸。
  • 支持 JPEG 和 PNG 格式。
  • 可配置圖像質量設置。
  • 自動創建保存文件的目錄。

📚 詳細文檔

工具

1. enum_screen_sources
   • 枚舉系統中所有可用的屏幕和窗口源，並返回一個 SimpleScreenSourceInfo 列表。
   • 返回類型：list[SimpleScreenSourceInfo]
2. create_snapshot
   • 創建指定源 ID 的屏幕截圖並將其作為圖像返回。
   • 輸入參數：
     • source_id: int（源 ID）
     • snapshot_size: tuple[int, int]（截圖尺寸）
   • 返回類型：Image
3. save_snapshot
   • 將指定源 ID 的屏幕截圖保存到文件中。
   • 輸入參數：
     • source_id: int（源 ID）
     • snapshot_size: tuple[int, int]（截圖尺寸）
     • file_path: str（文件路徑）
   • 返回類型：None

示例

圖像格式支持

• 默認使用 JPEG 格式，文件大小較小，適合網絡傳輸。
• 支持 PNG 格式，提供更高的圖像質量。

注意事項

⚠️ 重要提示

• 自動創建保存路徑中所需的目錄結構。
• 配置文件和日誌路徑請確保權限正確。
• 保持服務器與客戶端的網絡連接穩定。

依賴項

• Python >= 3.10
• 必要的庫包括：Pillow、uvicorn、fastapi 等，請根據需求安裝最新版本。

📄 許可證

[此處插入相關許可證信息，如 MIT License 或 Apache License 等]

此文檔詳細介紹了 TRAA MCP 服務器的功能、使用方法及其配置細節，幫助用戶順利部署和使用該工具。