{"_id":"@buildappolis/sharex-mcp-server","name":"@buildappolis/sharex-mcp-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@buildappolis/sharex-mcp-server","version":"1.0.0","description":"Model Context Protocol server for seamless ShareX integration with Claude Code - view screenshots and GIFs instantly","main":"dist/index.js","type":"module","bin":{"sharex-mcp":"dist/cli.js","sharex-mcp-init":"dist/init.js"},"scripts":{"build":"tsc","dev":"tsx watch src/index.ts","start":"node dist/index.js","inspect":"tsx src/index.ts","prepublishOnly":"pnpm build","prepack":"pnpm build","release:patch":"npm version patch && npm publish --access public","release:minor":"npm version minor && npm publish --access public","release:major":"npm version major && npm publish --access public"},"keywords":["mcp","model-context-protocol","sharex","screenshots","gifs","claude","claude-code","ai","windows","wsl","buildappolis"],"author":{"name":"BuildAppolis","url":"https://www.buildappolis.com"},"contributors":[{"name":"Cory","url":"https://github.com/hellocory"}],"license":"MIT","repository":{"type":"git","url":"git+https://github.com/hellocory/sharex-mcp-server.git"},"homepage":"https://github.com/hellocory/sharex-mcp-server#readme","bugs":{"url":"https://github.com/hellocory/sharex-mcp-server/issues"},"packageManager":"pnpm@10.11.0","devDependencies":{"@modelcontextprotocol/sdk":"^1.17.2","@types/mime-types":"^3.0.1","@types/node":"^24.2.1","@types/prompts":"^2.4.9","tsx":"^4.20.4","typescript":"^5.9.2"},"dependencies":{"chalk":"^5.5.0","chokidar":"^4.0.3","commander":"^14.0.0","mime-types":"^3.0.1","ora":"^8.2.0","prompts":"^2.4.2","sharp":"^0.34.3","shelljs":"^0.10.0"},"_id":"@buildappolis/sharex-mcp-server@1.0.0","gitHead":"48c0aca94378fe2934b0ed18645395df4a6296f7","types":"./dist/index.d.ts","_nodeVersion":"20.19.4","_npmVersion":"10.8.2","dist":{"integrity":"sha512-VHr2AU1WEsf+DTD88yjUW22fpszMIDJa2+qPf38N2Cm7Wi1n3Hizle9CdwuDrUFJiswcO01N5ZNCmdFdUmsMrw==","shasum":"11dac6b5dca96a040cc3a4476bf860f0300839b4","tarball":"https://registry.npmjs.org/@buildappolis/sharex-mcp-server/-/sharex-mcp-server-1.0.0.tgz","fileCount":31,"unpackedSize":66517,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDmlpGzTIHjYlMewRsfcUhGJkxwH4LIdqzIqLMy80Q4tAiEA3uxgUDc8KADW0zEAEVk789GjSjnt3yniFvvV+IohEBE="}]},"_npmUser":{"name":"gh5t","email":"cory@gcodes.org"},"directories":{},"maintainers":[{"name":"gh5t","email":"cory@gcodes.org"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sharex-mcp-server_1.0.0_1755125792890_0.1793331939819196"},"_hasShrinkwrap":false}},"time":{"created":"2025-08-13T22:56:32.798Z","1.0.0":"2025-08-13T22:56:33.069Z","modified":"2025-08-13T22:56:33.342Z"},"maintainers":[{"name":"gh5t","email":"cory@gcodes.org"}],"description":"Model Context Protocol server for seamless ShareX integration with Claude Code - view screenshots and GIFs instantly","homepage":"https://github.com/hellocory/sharex-mcp-server#readme","keywords":["mcp","model-context-protocol","sharex","screenshots","gifs","claude","claude-code","ai","windows","wsl","buildappolis"],"repository":{"type":"git","url":"git+https://github.com/hellocory/sharex-mcp-server.git"},"contributors":[{"name":"Cory","url":"https://github.com/hellocory"}],"author":{"name":"BuildAppolis","url":"https://www.buildappolis.com"},"bugs":{"url":"https://github.com/hellocory/sharex-mcp-server/issues"},"license":"MIT","readme":"# ShareX MCP Server\n\nA Model Context Protocol (MCP) server that seamlessly integrates ShareX screenshots and GIFs with Claude Code, enabling AI-powered analysis of your visual content.\n\nBuilt by [BuildAppolis](https://www.buildappolis.com) - *Building the future, one app at a time.*\n\n## Features\n\n### 📸 Screenshot Management\n- **Instant Access**: View your latest screenshots directly in Claude Code\n- **Multi-Screenshot Support**: Retrieve up to 5 recent screenshots at once\n- **Smart Caching**: Tracks your 10 most recent screenshots automatically\n- **File Metadata**: See file sizes, timestamps, and types at a glance\n\n### 🎬 Advanced GIF Handling\n- **Automatic Frame Extraction**: GIFs are automatically broken down into individual frames\n- **Indexed Selection**: Access GIFs by number (1-5) for easy reference\n- **Smart Frame Sampling**: Intelligently selects frames from long GIFs\n- **Large File Support**: Handles GIFs up to 50MB with graceful degradation\n- **Frame Caching**: Extracted frames are cached for instant access\n\n### 🔄 Real-Time Monitoring\n- **Live Updates**: Automatically detects new screenshots as you take them\n- **File Watching**: Monitors your ShareX screenshot directory in real-time\n- **Auto-Cleanup**: Maintains optimal performance by managing cache limits\n\n## Quick Start\n\n### Prerequisites\n- Windows 10/11 or WSL\n- [ShareX](https://getsharex.com/) installed and configured\n- [Claude Code](https://claude.ai/download) installed\n- Node.js 18+ (for installation)\n\n### Installation\n\n#### Windows (PowerShell)\n```powershell\n# One-line installer\niwr -useb https://raw.githubusercontent.com/hellocory/sharex-mcp-server/main/setup.ps1 | iex\n```\n\n#### WSL/Linux\n```bash\n# One-line installer\ncurl -fsSL https://raw.githubusercontent.com/hellocory/sharex-mcp-server/main/install.sh | bash\n```\n\nThe installer will:\n1. Download and install the MCP server\n2. Register it with Claude Code automatically\n3. Configure everything for immediate use\n\n### Verify Installation\n```bash\n# Check if the server is registered\nclaude mcp list\n\n# You should see:\n# sharex: ✓ Connected\n```\n\n## Usage\n\n### Basic Commands\n\nOnce installed, just ask Claude:\n\n- **\"Look at my latest screenshot\"** - Shows your most recent screenshot\n- **\"Check my latest GIF\"** - Automatically extracts and displays frames from your latest GIF\n- **\"Show me the last 3 screenshots\"** - Displays multiple recent screenshots\n- **\"List my GIFs\"** - Shows numbered list of available GIFs\n- **\"Show GIF number 2\"** - Displays the second most recent GIF\n\n### Taking Screenshots with ShareX\n\n1. Press your ShareX hotkey (default: `PrtScn`)\n2. Capture your screen area\n3. Ask Claude to view it immediately - no file navigation needed!\n\n### Recording GIFs with ShareX\n\n1. Press your ShareX GIF hotkey (default: `Shift+PrtScn`)\n2. Record your screen\n3. Stop recording\n4. Ask Claude to view the GIF - frames are extracted automatically!\n\n## Features in Action\n\n### Smart GIF Processing\nWhen you ask to see a GIF, the server:\n- Detects the GIF format automatically\n- Extracts up to 10 representative frames\n- Shows frame numbers and metadata\n- Caches the extraction for instant replay\n\n### Indexed Access\n```\nUser: \"List my GIFs\"\nClaude: Available GIFs:\n1. screen_recording.gif - 2.3 MB - 2 mins ago\n2. demo_animation.gif - 1.1 MB - 10 mins ago\n3. bug_report.gif - 4.5 MB - 1 hour ago\n\nUser: \"Show number 3\"\nClaude: [Displays frames from bug_report.gif]\n```\n\n## Configuration\n\nThe MCP server uses ShareX's default screenshot location automatically. If you've customized your ShareX settings, the server will detect and use your custom path.\n\n### Default Limits\n- **Screenshots**: Tracks 10 most recent\n- **GIFs**: Tracks 5 most recent\n- **Frames per GIF**: Extracts up to 10 frames\n- **Max GIF size**: 50MB\n\n## Troubleshooting\n\n### Server Not Connected\n```bash\n# Re-register the server\nclaude mcp remove sharex\nclaude mcp add sharex --scope user -- cmd /c node \"C:\\Users\\%USERNAME%\\sharex-mcp-server\\dist\\index.js\"\n```\n\n### Can't See Screenshots\n1. Ensure ShareX is saving to Documents\\ShareX\\Screenshots\n2. Take a new screenshot to trigger detection\n3. Check server status: `claude mcp list`\n\n### GIF Issues\n- GIFs over 50MB will show metadata only\n- Corrupted GIFs will display an error message\n- Try recording a shorter GIF if extraction fails\n\n## Uninstall\n\n### Windows\n```powershell\nclaude mcp remove sharex\nRemove-Item -Recurse -Force \"$env:USERPROFILE\\sharex-mcp-server\"\n```\n\n### WSL\n```bash\nclaude mcp remove sharex\nrm -rf ~/sharex-mcp-server\n```\n\n## Contributing\n\nWant to help improve ShareX MCP Server? Check out our [Contributing Guide](CONTRIBUTING.md) for development setup and guidelines.\n\n## Support\n\n- **Issues**: [GitHub Issues](https://github.com/hellocory/sharex-mcp-server/issues)\n- **Updates**: [GitHub Releases](https://github.com/hellocory/sharex-mcp-server/releases)\n- **Developer**: [BuildAppolis](https://www.buildappolis.com)\n\n## License\n\nMIT License - See [LICENSE](LICENSE) file for details.\n\n---\n\n*ShareX MCP Server is a [BuildAppolis](https://www.buildappolis.com) project, crafted with care to enhance your AI-assisted workflow.*","readmeFilename":"README.md","_rev":"1-a2c9c6cbac29ea9604dcc01bcce7484b"}