Screeny

🚀 Screeny MCP Server: プライバシーを重視したmacOS用スクリーンショット取得サーバー

AIエージェント向けの、プライバシーを重視したmacOS専用のMCPサーバーです。事前に承認されたアプリケーションウィンドウのスクリーンショットをキャプチャし、開発やデバッグタスクにセキュアなビジュアルコンテキストを提供します。

⚠️ 重要提示

スクリーンキャプチャの許可とウィンドウ承認の設定が必要です - 以下の手順を参照してください。

🚀 クイックスタート

このサーバーを使用する前に、スクリーンキャプチャの許可を付与し、ウィンドウの承認を行う必要があります。詳細な手順は以下のセクションを参照してください。

✨ 主な機能

🔒 プライバシーを重視した設計

他のスクリーンショットツールとは異なり、Screenyは各ウィンドウをキャプチャする前に、ユーザーの明示的な承認を必要とします。

• ウィンドウ承認システム - 事前に承認されたウィンドウのみをキャプチャできます（セットアップ時に承認）
• ユーザーが制御するアクセス - どのウィンドウにアクセスできるかを完全にユーザーが決定できます
• 非侵入的なキャプチャ - ウィンドウのフォーカスを変更したり、作業を中断したりすることなく、バックグラウンドでスクリーンショットを撮ります
• 外部接続なし - Screenyは完全にデバイス上で実行され、スクリーンショットは使用後すぐに削除されます

利用可能なツール

• listWindows - スクリーンショットキャプチャが可能な、承認されたすべてのアプリケーションウィンドウを一覧表示します。
  • ユーザーが承認したウィンドウのみを表示します
• takeScreenshot - 特定のウィンドウのIDを指定して、そのウィンドウのスクリーンショットをキャプチャします。
  • バックグラウンドでウィンドウをキャプチャ - ウィンドウを前面に持ってくる必要はありませんが、最小化されたウィンドウはキャプチャできません
  • 実際のピクセルデータを提供 - 完全な忠実度の画像で、OCRやテキスト抽出ではありません
  • 画像を圧縮可能 - 必要に応じて、大きな画像を1MB以内に収めるように圧縮できます

リソース

• screeny://info - サーバーの情報と設定の詳細

📦 インストール

Claude Desktop

1. Claudeの設定を開き → 開発者 → 設定を編集
2. 設定を追加
3. 設定を保存した後、Claude Desktopを再起動します

{
  "mcpServers": {
    "screeny": {
      "command": "mcp-server-screeny",
      "args": []
    }
  }
}

{
  "mcpServers": {
    "screeny": {
      "command": "uvx",
      "args": ["mcp-server-screeny"]
    }
  }
}

Cursor

1. Cursorの設定を開き → ツールと統合 → MCPツール
2. 設定を追加
3. 設定を保存した後、Cursorを再起動します

{
  "mcpServers": {
    "screeny": {
      "command": "mcp-server-screeny",
      "args": []
    }
  }
}

{
  "mcpServers": {
    "screeny": {
      "command": "uvx",
      "args": ["mcp-server-screeny"]
    }
  }
}

🔧 セットアップ

1. スクリーンキャプチャの許可を付与する（必須）

重要：ウィンドウ承認を実行する前に、許可を付与してください。

注意：以下の両方にスクリーンキャプチャの許可を付与する必要があります。

1. ターミナルアプリケーション（Terminal.app、iTerm2など） - セットアップを実行するために必要です（セットアップ後は無効にできます）
2. MCPホスト（Claude Desktop、Cursor） - スクリーンショットを撮るために必要です

追加するには、以下の手順を実行します。

1. システム設定 > プライバシーとセキュリティ > 画面とシステムオーディオの録画を開きます
2. "+" ボタンをクリックします
3. ターミナルアプリケーションとMCPホストアプリケーションを追加します
4. 許可を付与した後、両方のアプリケーションを再起動します

2. ウィンドウ承認（必須）

上記のMCPクライアントを設定した後、どのウィンドウをキャプチャできるかを承認します。

# 対話型承認
mcp-server-screeny --setup

# 現在のすべてのウィンドウを自動承認
mcp-server-screeny --setup --allow-all

# 対話型承認
uvx mcp-server-screeny --setup

# 現在のすべてのウィンドウを自動承認
uvx mcp-server-screeny --setup --allow-all

承認情報は~/.screeny/approved_windows.jsonに保存されます。承認済みのウィンドウのリストを更新する場合は、セットアップを再度実行してください。

🛡️ セキュリティとプライバシー

• ユーザーが承認したウィンドウのみをキャプチャできます
• すべての処理はローカルマシン上で行われます
• スクリーンショットは一時的なもので、使用後すぐに削除されます

🐞 トラブルシューティング

権限に関する問題

# ウィンドウ検出と権限をテストする
mcp-server-screeny --debug

# ウィンドウが変更された場合は、セットアップを再度実行する
mcp-server-screeny --setup

一般的な問題

"spawn uvx ENOENT"エラー

• 解決策：MCP設定で"uvx"の代わりにuvxの完全パスを使用してください
• パスを取得するには：which uvxを実行します
• 例："/opt/homebrew/bin/uvx" または "/usr/local/bin/uvx"

"No approved windows found"

• 解決策：まずmcp-server-screeny --setupを実行してください（uvxを使用する場合はuvx mcp-server-screeny --setup）

"Screen Recording permission required" または "No windows found"

• 解決策：システム設定 > プライバシーとセキュリティ > 画面とシステムオーディオの録画で、スクリーン録画の許可を付与してください。
  • "+" ボタンをクリックし、MCPホスト（Claude Desktop、Cursorなど）を手動で追加します。
  • 許可を付与した後、MCPホストアプリケーションを再起動します。
• 許可を付与した後、セットアップを再度実行してみてください。

🤝 コントリビューション

プルリクエストは大歓迎です！新しいアイデア、バグ修正、または機能強化など、自由に貢献してください。

これは私の最初のMCPプロジェクトです。もしバグに遭遇した場合は、Issueを開いてください。できる限り修正します！

📋 要件

• Python 3.10以上
• macOS
• スクリーンキャプチャの許可

📄 ライセンス

MITライセンス