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

Using NPM package (recommended)

Using Docker (optional)

Development

Install dependencies:

Build the server:

For development with auto-rebuild:

Docker Build (optional)