MCP Screenshot Server

🚀 🖼️ MCP スクリーンショットサーバー

この軽量なスクリーンショットマイクロサービスはMCPと互換性があり、FastAPIを使用してWindows用に構築されています。AIエージェントや自動化ツールが簡単なHTTP呼び出しで、全画面、特定の領域、またはウィンドウのスクリーンショットを取得できるようにします。

🚀 クイックスタート

このMCPスクリーンショットサーバーは、AIエージェントや自動化ツールが簡単なHTTP呼び出しでスクリーンショットを取得できるようにする軽量なサービスです。以下のセクションでは、その機能、使用方法、技術的な詳細について説明します。

✨ 主な機能

• 📸 全画面スクリーンショットの取得
• 🪟 タイトルで特定のウィンドウを指定してスクリーンショットを取得
• 🔲 指定した領域 [x, y, 幅, 高さ] のスクリーンショットを取得
• 🧠 MCP互換のREST API
• 🖼️ PNGまたはbase64形式の画像を返す
• 🚀 FastAPIで構築されており、本番環境やLLMでの使用に適している

📦 インストール

git clone https://github.com/yourusername/mcp-screenshot-server.git
cd mcp-screenshot-server
python -m venv .venv
source .venv/bin/activate   # または .venv\Scripts\activate (Windowsの場合)
pip install -r requirements.txt
uvicorn main:app --reload

💻 使用例

基本的な使用法

{
  "region": [0, 0, 1280, 720],        // オプションパラメータ
  "window_title": "Untitled - Notepad", // オプションパラメータ
  "base64": true                      // オプションパラメータ (デフォルト: false)
}

高度な使用法

{
  "status": "ok",
  "mode": "region",
  "image_format": "base64",
  "image": "<base64-encoded-image>"
}

📚 ドキュメント

POST /screenshot

リクエストJSONボディ：

{
  "region": [0, 0, 1280, 720],        // オプションパラメータ
  "window_title": "Untitled - Notepad", // オプションパラメータ
  "base64": true                      // オプションパラメータ (デフォルト: false)
}

レスポンス（base64モード）：

{
  "status": "ok",
  "mode": "region",
  "image_format": "base64",
  "image": "<base64-encoded-image>"
}

🔧 技術詳細

• Python 3.11+
• FastAPI
• mss または pyautogui スクリーンショットツール
• pillow 画像処理ライブラリ
• pygetwindow ウィンドウマッチング（オプション）

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。自由に使用、フォーク、統合することができます。詳細は LICENSE を参照してください。

📬 貢献ガイド

Pull RequestやIssuesの投稿を歓迎します！PRを通じて機能を追加したり、クロスプラットフォームの互換性を向上させたり（例: Mac/Linuxサポート）することができます。

🙋 よくある質問

• Linux/macOSでの実行は可能ですか？
  現在のバージョンはWindowsに焦点を当てていますが、他のプラットフォームをサポートするように拡張することは歓迎されます。

• MCP認証を受けていますか？
  このプロジェクトは、LLMエージェントとの最大限の互換性を実現するために、可能な限りMCP規格に準拠するように設計されています。

🧠 インスピレーションの源

• Anthropicの モデルコンテキストプロトコル
• 実際のLLM駆動の自動化シナリオ