📌Overview

Purpose: To provide a Model Context Protocol server for integrating Gyazo images, allowing AI assistants to interact with Gyazo images seamlessly.

Overview: The gyazo-mcp-server is a TypeScript-based solution that facilitates access to Gyazo images via the Model Context Protocol. It enables applications to retrieve and work with image resources, enhancing functionality through metadata and content sharing with intelligent systems.

Key Features:

• Resources: Provides access to Gyazo images via gyazo-mcp:// URIs, delivering original content, metadata (including title, description, app, URL), and optional OCR data for various image formats (JPEG, PNG, etc.).

• Tools: Offers the gyazo_latest_image functionality to fetch the most recent Gyazo image, returning both content and metadata, including any available OCR text.

---

gyazo-mcp-server

A Model Context Protocol server for Gyazo image integration.

This TypeScript-based MCP server provides access to Gyazo images, allowing AI assistants to interact with images through the Model Context Protocol. It offers:

• Resources representing Gyazo images with URIs and metadata
• Tools for fetching the latest image
• Access to image content and metadata 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_latest_image - Fetch the most recent image from Gyazo
  • Returns image content and metadata
  • Includes OCR text if available

Development

Install dependencies:

npm ci

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Docker

npm run image:build

Installation

Prerequisites

1. Create a Gyazo account if you don't have one: https://gyazo.com
2. Get your Gyazo API access token from: https://gyazo.com/api
3. 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

Example configuration:

{
  "mcpServers": {
    "gyazo-mcp-server": {
      "command": "/path/to/gyazo-mcp-server/build/index.js",
      "env": {
        "GYAZO_ACCESS_TOKEN": "your-access-token-here"
      }
    }
  }
}

Docker Integration

{
  "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"
      }
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. It is recommended to use the MCP Inspector, available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.