ShareX MCP服务器
一个模型上下文协议（MCP）服务器，将ShareX屏幕截图和GIF与Claude Code无缝集成，实现了对视觉内容的AI分析。
建造于 BuildAppolis - *构建未来，一次一个应用程序。*
特性
📸 屏幕截图管理
- 即刻进入：直接在Claude Code中查看您的最新截图
- 多屏幕截图支持：一次最多检索5个最近的屏幕截图
- 智能缓存：自动跟踪您最近的10个屏幕截图
- 文件元数据：一目了然地查看文件大小、时间戳和类型
🎬 高级GIF处理
- 自动帧提取：GIF会自动分解为单独的帧
- 索引选择：按数字（1-5）访问GIF，以便于参考
- 智能帧采样：从长GIF中智能选择帧
- 大文件支持：可处理高达50MB的GIF，并可优雅降级
- 帧缓存：提取的帧被缓存以供即时访问
🔄 实时监控
- 实时更新：在拍摄时自动检测新的屏幕截图
- 文件监视：实时监控您的ShareX屏幕截图目录
- 自动清理：通过管理缓存限制来保持最佳性能
快速开始
先决条件
安装
选项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安装程序将：
- 在Windows上安装MCP服务器
- 在Windows上用Claude Code注册
- 自动检测和配置任何WSL发行版
- 设置所有内容以供立即使用
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进行屏幕截图
- 按ShareX热键（默认值：
PrtScn) - 捕获您的屏幕区域
- 让克劳德立即查看它——不需要文件导航！
使用ShareX录制GIF
- 按ShareX GIF热键（默认值：
Shift+PrtScn) - 录制您的屏幕
- 停止录制
- 让克劳德查看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"看不到屏幕截图
- 确保ShareX正在保存到Documents\\ShareX\\Screenshots
- 拍摄新的屏幕截图以触发检测
- 检查服务器状态：
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服务器吗？查看我们的 贡献指南 用于开发设置和指南。
支持
- 问题:
- 更新:
- 开发者: BuildAppolis
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
______________________________________________________________________
*ShareX MCP服务器是 BuildAppolis 该项目精心打造，旨在增强您的人工智能辅助工作流程。*