Traa Mcp

TRAA MCP Server

TRAA MCP Serverは、Model Context Protocol（MCP）に基づく画面キャプチャサーバーです。システムの画面やウィンドウの一覧表示、スクリーンショットのキャプチャ機能を提供します。サーバーはMCPプロトコルを通じてクライアントと通信し、標準入出力（stdio）とServer-Sent Events（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"
            ]
        }
    }
}

サーバー側

サーバーは、次の2つの実行モードに対応しています。

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モデルとの互換性を考慮し、ファイルサイズを1MB未満に抑えるため、デフォルトでは品質60のJPEG形式を使用します
• ファイルの保存時、親ディレクトリが存在しない場合は自動的に作成されます
• トラブルシューティングを容易にするため、詳細なメッセージを含むエラー処理を行います

ライセンス

詳細については、LICENSEファイルをご覧ください。