AI导哈

截图与GIF分析服务器

一个与Claude Code无缝集成的模型上下文协议（MCP）服务器，用于AI驱动的视觉内容分析。

  • by BuildAppolis
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 BuildAppolis/sharex-mcp-server

使用说明

ShareX MCP服务器

一个模型上下文协议（MCP）服务器，将ShareX屏幕截图和GIF与Claude Code无缝集成，实现了对视觉内容的AI分析。

建造于 BuildAppolis - 构建未来，一次一个应用程序。

特性

📸 屏幕截图管理

  • 即刻进入：直接在Claude Code中查看您的最新截图
  • 多屏幕截图支持：一次最多检索5个最近的屏幕截图
  • 智能缓存：自动跟踪您最近的10个屏幕截图
  • 文件元数据：一目了然地查看文件大小、时间戳和类型

🎬 高级GIF处理

  • 自动帧提取：GIF会自动分解为单独的帧
  • 索引选择：按数字（1-5）访问GIF，以便于参考
  • 智能帧采样：从长GIF中智能选择帧
  • 大文件支持：可处理高达50MB的GIF，并可优雅降级
  • 帧缓存：提取的帧被缓存以供即时访问

🔄 实时监控

  • 实时更新：在拍摄时自动检测新的屏幕截图
  • 文件监视：实时监控您的ShareX屏幕截图目录
  • 自动清理：通过管理缓存限制来保持最佳性能

快速开始

先决条件

  • Windows 10/11（可选WSL支持）
  • ShareX 安装在Windows上
  • 克劳德代码 安装
  • Node.js 18+（用于安装）

安装

选项1：从NPM安装（推荐）

# Install globally
npm install -g @buildappolis/sharex-mcp-server

# Register with Claude Code
claude mcp add sharex -- npx -y @buildappolis/sharex-mcp-server

选项2：快速安装脚本

Windows（PowerShell）-还会自动配置WSL

# One-line installer that handles both Windows and WSL
iwr -useb https://raw.githubusercontent.com/buildappolis/sharex-mcp-server/main/setup.ps1 | iex

安装程序将：

  1. 在Windows上安装MCP服务器
  2. 在Windows上用Claude Code注册
  3. 自动检测和配置任何WSL发行版
  4. 设置所有内容以供立即使用

WSL用户： Windows安装程序会自动配置WSL以连接到Windows安装的服务器。如果安装后需要手动配置WSL：

# In WSL, register the Windows server
claude mcp add sharex --scope user -- node /mnt/c/Users/YOUR_USERNAME/sharex-mcp-server/dist/index.js

验证安装

# Check if the server is registered
claude mcp list

# You should see:
# sharex: ✓ Connected

用法

基本命令

安装后，只需询问Claude：

  • “看看我最新的截图” -显示您最近的屏幕截图
  • “检查我的最新GIF” -自动提取并显示最新GIF中的帧
  • “显示最后3个屏幕截图” -显示多个最近的屏幕截图
  • “列出我的GIF” -显示可用GIF的编号列表
  • “显示GIF数字2” -显示第二个最近的GIF

使用ShareX进行屏幕截图

  1. 按ShareX热键（默认值： PrtScn)
  2. 捕获您的屏幕区域
  3. 让克劳德立即查看它——不需要文件导航！

使用ShareX录制GIF

  1. 按ShareX GIF热键（默认值： Shift+PrtScn)
  2. 录制您的屏幕
  3. 停止录制
  4. 让克劳德查看GIF——GIF帧是自动提取的！

功能在行动

智能GIF处理

当您要求查看GIF时，服务器：

  • 自动检测GIF格式
  • 提取多达10个代表性帧
  • 显示帧编号和元数据
  • 缓存提取内容以进行即时回放

索引访问

User: "List my GIFs"
Claude: Available GIFs:
1. screen_recording.gif - 2.3 MB - 2 mins ago
2. demo_animation.gif - 1.1 MB - 10 mins ago
3. bug_report.gif - 4.5 MB - 1 hour ago

User: "Show number 3"
Claude: [Displays frames from bug_report.gif]

配置

MCP服务器自动使用ShareX的默认屏幕截图位置。如果您自定义了ShareX设置，服务器将检测并使用您的自定义路径。

默认限制

  • 截图：曲目10最新
  • 礼品：曲目5最新
  • 每个GIF的帧数：最多提取10帧
  • 最大GIF大小：50 MB

故障排除

服务器未连接

如果使用NPM包：

# Re-register the server
claude mcp remove sharex
claude mcp add sharex -- npx -y @buildappolis/sharex-mcp-server

如果使用本地安装：

# Re-register the server
claude mcp remove sharex
claude mcp add sharex --scope user -- cmd /c node "C:\Users\%USERNAME%\sharex-mcp-server\dist\index.js"

看不到屏幕截图

  1. 确保ShareX正在保存到Documents\ShareX\Screenshots
  2. 拍摄新的屏幕截图以触发检测
  3. 检查服务器状态： claude mcp list

GIF问题

  • 大于50MB的GIF将仅显示元数据
  • 损坏的GIF将显示错误消息
  • 如果提取失败，请尝试录制较短的GIF

卸载

NPM包

# Remove from Claude Code
claude mcp remove sharex

# Uninstall package
npm uninstall -g @buildappolis/sharex-mcp-server

本地安装

视窗

claude mcp remove sharex
Remove-Item -Recurse -Force "$env:USERPROFILE\sharex-mcp-server"

WSL

claude mcp remove sharex
rm -rf ~/sharex-mcp-server

贡献

想帮助改进ShareX MCP服务器吗？查看我们的 贡献指南 用于开发设置和指南。

支持

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

ShareX MCP服务器是 BuildAppolis 该项目精心打造，旨在增强您的人工智能辅助工作流程。

相关 MCP