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:

npm install -g @notainc/gyazo-mcp-server

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)

{
  "mcpServers": {
    "gyazo-mcp-server": {
      "command": "npx",
      "args": ["@notainc/gyazo-mcp-server"],
      "env": {"GYAZO_ACCESS_TOKEN": "your-access-token-here"}
    }
  }
}

Using Docker (optional)

{
  "mcpServers": {
    "gyazo-mcp-server": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "GYAZO_ACCESS_TOKEN", "gyazo-mcp-server"],
      "env": {"GYAZO_ACCESS_TOKEN": "your-access-token-here"}
    }
  }
}

Development

Install dependencies:

npm ci

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Docker Build (optional)

npm run image:build