Skip to main content
Glama

📸 screenshot-mcp

给 AI 装上一双眼睛 — 让 Claude Code 能截图、看图、自动清理的 MCP 服务器

License: MIT Node.js Platform MCP


这是什么?

screenshot-mcp 是一个 MCP (Model Context Protocol) 服务器,让 AI 助手(如 Claude Code)可以直接在你的 Windows 桌面上:

能力

说明

📷 截图

全屏截图、区域截图、活动窗口截图

👁️ 看图

读取图片让 AI 视觉分析

🗑️ 自动删图

按条件清理旧截图,用完即走

工作原理

┌──────────────────────┐         MCP 协议          ┌──────────────────────┐
│                      │◄──────────────────────►│                      │
│   Claude Code        │     tools/list           │   screenshot-mcp     │
│   (MCP 客户端)        │     tools/call           │   (MCP 服务器)       │
│                      │                          │                      │
│  "帮我看看桌面" ──────┼── screenshot ──────────►│  PowerShell .NET     │
│  "这个界面怎么样" ─────┼── screenshot_region ────►│  System.Drawing      │
│  "把截图删掉" ────────┼── cleanup ──────────────►│  fs.unlinkSync       │
└──────────────────────┘                          └──────────────────────┘
                                                           │
                                              ┌────────────┴────────────┐
                                              │   Windows 原生截图 API   │
                                              │   (无需额外工具)          │
                                              └─────────────────────────┘

Related MCP server: screen-capture-mcp

快速开始

前置要求

  • Windows 10/11(截图依赖 Windows GDI+)

  • Node.js 18 或更高版本

  • Claude Code(或其他 MCP 客户端)

安装

# 1. 克隆仓库
git clone https://github.com/你的用户名/screenshot-mcp.git
cd screenshot-mcp

# 2. 安装依赖
npm install

配置(选一种即可)

方式一:全局配置(推荐,所有项目生效)

编辑 ~/.claude.json(在 C:\Users\你的用户名\.claude.json),在 mcpServers 里添加:

"mcpServers": {
  "playwright": {
    "type": "stdio",
    "command": "npx",
    "args": ["@playwright/mcp", "--headless"],
    "env": {}
  },
  "screenshot-mcp": {
    "command": "node",
    "args": ["C:\\你的路径\\screenshot-mcp\\src\\index.js"]
  }
}

路径说明args 中的路径要改成你电脑上的实际路径,例如:

  • 项目在桌面:C:\Users\你的用户名\Desktop\screenshot-mcp\src\index.js

  • 项目在 D 盘:D:\projects\screenshot-mcp\src\index.js

方式二:项目级配置(仅当前项目生效)

在项目目录下创建 .claude/settings.json

{
  "mcpServers": {
    "screenshot-mcp": {
      "command": "node",
      "args": ["C:\\你的路径\\screenshot-mcp\\src\\index.js"]
    }
  }
}

方式三:.mcp.json 文件(自动发现)

在工作目录下创建 .mcp.json,Claude Code 会自动发现并加载:

{
  "mcpServers": {
    "screenshot-mcp": {
      "command": "node",
      "args": ["C:\\你的路径\\screenshot-mcp\\src\\index.js"]
    }
  }
}

验证配置是否生效

重启 Claude Code 后,随便说一句:

"你能用 screenshot-mcp 吗?"

如果配置正确,Claude 会回答"可以"并调用截图工具。

使用

配置好后,在 Claude Code 中直接说:

🗣️ "帮我截个图看看桌面" 🗣️ "截取当前活动窗口" 🗣️ "看看这张图片" 🗣️ "把刚才的截图删掉" 🗣️ "清理超过1小时的截图"


提供的工具

工具

说明

参数

screenshot

全屏截图

filename(可选,自定义文件名)

screenshot_region

区域/活动窗口截图

filename(可选),region(可选:"active_window""x,y,width,height"

view_image

读取图片给 AI 分析

path(必填,图片路径)

list_images

列出所有截图

limit(可选,默认 20)

delete_image

删除指定图片

path(必填)

cleanup

批量清理截图

older_than_hours(可选),pattern(可选,文件名前缀)


使用示例

截图 + AI 分析

你:帮我截个图,看看我桌面上有什么
Claude:(调用 screenshot 截图)
       (调用 view_image 看图)
      → 你桌面上有这些文件和文件夹……

截图指定区域

你:截取当前活动窗口
Claude:(调用 screenshot_region region="active_window")
      → 这是当前窗口的内容……

看完自动清理

你:把刚才的截图删掉
Claude:(调用 delete_image 删除指定文件)
      → 已删除

安全性

措施

说明

🛡️ 目录限制

delete_imagecleanup 只能操作 screenshots/ 目录下的文件

📦 文件大小限制

图片最大支持 20MB

🔒 本地存储

截图保存在本地 screenshots/ 目录,不会外传

🧹 自动清理

支持按时间批量清理,用完即删


技术栈

技术

用途

Node.js

运行环境

@modelcontextprotocol/sdk

MCP 协议实现

PowerShell .NET (System.Drawing)

Windows 原生截图

JSON-RPC 2.0

通信协议

纯 Windows 原生实现,无需任何第三方截图工具。


在 GitHub 上使用

如果你把这个项目放在 GitHub 上,别人克隆后会得到一份不带配置的源码。他们需要:

  1. 运行 npm install 安装依赖

  2. 在自己的 Claude Code 配置中注册这个 MCP 服务器

  3. args 中的路径改成自己机器上的实际路径


开源协议

MIT — 随便用,随便改,随便玩。


相关资源


screenshot-mcp — 给 AI 装上一双眼睛 👀

Install Server
A
license - permissive license
A
quality
-
maintenance - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Augments MCP Server - A comprehensive framework documentation provider for Claude Code

  • Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer

  • MCP server for Grok Imagine AI video generation

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cai-cai-jun/screenshot-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server