Screenshot MCP Server

🚀 截圖 MCP 服務器

這是一個具備截圖功能的MCP服務器，能讓AI工具捕獲並處理屏幕內容，為AI分析用戶屏幕畫面提供支持。

🚀 快速開始

此MCP服務器可讓AI工具捕獲用戶屏幕截圖，便於AI助手查看和分析用戶當前所見內容。服務器負責圖像的捕獲、壓縮與傳輸，以適配AI處理的格式提供圖像。

✨ 主要特性

• 可捕獲全屏截圖。
• 自動進行JPEG壓縮，實現高效傳輸。
• 採用Base64編碼圖像數據，確保傳輸可靠。
• 支持stdio和SSE兩種傳輸模式。
• 圖像質量和優化選項可配置。
• 擁有簡單命令行界面，方便測試。

📦 安裝指南

從源代碼安裝

# 克隆倉庫
git clone https://github.com/codingthefuturewithai/screenshot_mcp_server.git
cd screenshot_mcp_server

# 使用UV進行安裝（推薦）
uv pip install -e .

# 或使用pip安裝
pip install -e .

📚 詳細文檔

可用工具

take_screenshot

描述：捕獲用戶屏幕的截圖並以JPEG格式返回。 參數：無 返回：

• JPEG格式的圖像內容，Base64編碼

使用方法

服務器可以通過兩種方式使用：

命令行客戶端

# 捕獲截圖並保存到文件中
screenshot_mcp_server-client output.jpg

編程式使用

from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async with stdio_client(StdioServerParameters(command="screenshot_mcp_server-server")) as (read, write):
    async with ClientSession(read, write) as session:
        result = await session.call_tool("take_screenshot")
        # 處理截圖數據...

要求

• Python 3.10或更高版本（但小於3.13）
• 依賴項：
  • mcp >= 1.0.0
  • pyautogui >= 0.9.54
  • Pillow >= 10.0.0
• 操作系統：Linux、macOS、Windows

配置

服務器支持兩種傳輸模式：

• stdio（默認）：用於命令行使用
• SSE：用於基於Web的應用，默認運行在3001端口

要在SSE模式下運行：

screenshot_mcp_server-server-sse --port 3001

📄 許可證

本項目遵循MIT許可證。

👨‍💻 作者

Tim Kitchens (timkitch@codingthefuture.ai)