Integrates with Gyazo to retrieve Gyazo images and metadata, enabling image analysis and content processing.
Created byApr 23, 2025
gyazo-mcp-server
A Model Context Protocol server for Gyazo image integration
This is a TypeScript-based MCP server that provides access to Gyazo images. It allows AI assistants to access and interact with Gyazo images through the Model Context Protocol, providing:
Resources representing Gyazo images with URIs and metadata
Tools for searching, fetching, and uploading images
Image content and metadata access via the Gyazo API
Features
Resources
List and access Gyazo images via `gyazo-mcp://` URIs
Each image includes:
- Original image content
- Metadata (title, description, app, URL)
- OCR data (if available)
Supports various image formats (JPEG, PNG, etc.)
Tools
`gyazo_search` - Full-text search for captures uploaded by users on Gyazo
- Search by keyword, title, app, URL, or date range
- Supports pagination for browsing multiple results
- Returns matching image URIs and metadata
`gyazo_image` - Fetch image content and metadata from Gyazo
- Retrieve specific images by ID or URL
- Returns both image content and detailed metadata
`gyazo_latest_image` - Fetch the most recent image from Gyazo
- Returns both image content and metadata
- Includes OCR text if available
`gyazo_upload` - Upload an image to Gyazo
- Upload images with base64 encoded image data
- Add optional metadata like title, description, referer URL, and app name
- Returns the uploaded image's permalink URL and ID
Installation
NPM Package
The easiest way to install the Gyazo MCP server is via npm:
Prerequisites
Create a Gyazo account if you don't have one: https://gyazo.com
Get your Gyazo API access token from: https://gyazo.com/api
- Click "Register applications" button
- Click "New Application" button
- Fill in the form with your app name and description
- Name and Callback URL are required
- You can use `http://localhost` for the Callback URL
- Click "Submit" button
- Click application name to view details
- Scroll down to "Your Access Token"
- Click "Generate" button
- Copy "Your access token" value
Set the `GYAZO_ACCESS_TOKEN` environment variable with your token
Claude Desktop Integration
To use with Claude Desktop, add the server config:
On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
On Windows: `%APPDATA%/Claude/claude_desktop_config.json`