Traa MCP

🚀 TRAA MCP サーバー

TRAA MCP サーバーは、モデルコンテキストプロトコル（MCP）に基づく画面キャプチャサーバーです。システムの画面とウィンドウを列挙し、スクリーンショットをキャプチャする機能を提供します。このサーバーは、MCP プロトコルを通じてクライアントと通信し、標準入出力（stdio）と Server-Sent Events (SSE) の2つの転送方式をサポートしています。

✨ 主な機能

画面とウィンドウソースの列挙

• システム内のすべての利用可能な表示デバイスをリストアップします。
• システム内のすべての利用可能なウィンドウをリストアップします。
• 各ソースには、ID、タイトル、タイプ（表示/ウィンドウ）、および位置情報が含まれます。

画面キャプチャ

• 指定された表示デバイスまたはウィンドウのスクリーンショットをキャプチャします。
• スクリーンショットのサイズをカスタマイズできます。
• JPEG と PNG 形式をサポートします。
• 画像品質設定を構成可能です。
• 保存ファイルのディレクトリを自動的に作成します。

🛠️ ツール

enum_screen_sources

• システム内のすべての利用可能な画面とウィンドウソースを列挙し、SimpleScreenSourceInfo のリストを返します。
• 戻り値の型: list[SimpleScreenSourceInfo]

create_snapshot

• 指定されたソース ID のスクリーンショットを作成し、画像として返します。
• 入力パラメータ:
  • source_id: int（ソース ID）
  • snapshot_size: tuple[int, int]（スクリーンショットのサイズ）
• 戻り値の型: Image

save_snapshot

• 指定されたソース ID のスクリーンショットをファイルに保存します。
• 入力パラメータ:
  • source_id: int（ソース ID）
  • 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つの起動モードをサポートしています。

標準入出力モード（デフォルト）:

uv run traa_mcp_server

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 形式を使用し、ファイルサイズが小さく、ネットワーク転送に適しています。
• PNG 形式もサポートしており、より高い画像品質を提供します。

⚠️ 注意事項

• 保存パスに必要なディレクトリ構造を自動的に作成します。
• 設定ファイルとログパスの権限が正しいことを確認してください。
• サーバーとクライアントのネットワーク接続を安定させてください。

📦 依存関係

• Python >= 3.10
• 必要なライブラリには、Pillow、uvicorn、fastapi などが含まれます。必要に応じて最新バージョンをインストールしてください。

📄 ライセンス

[ここに MIT License や Apache License などの関連ライセンス情報を挿入してください]