Gyazo

🚀 gyazo-mcp-server

Integrate Gyazo image collection into the Model Context Protocol (MCP) server

This is an MCP server built with TypeScript that provides access to Gyazo images. It allows AI assistants to access and interact with Gyazo images through the model context protocol, including:

• Represent Gyazo images via gyazo-mcp:// URIs and their metadata.
• Provide functions for searching, retrieving, and uploading images.
• Access image content and metadata through the Gyazo API.

✨ Features

Resources

• List and access Gyazo images using gyazo-mcp:// URIs.
• Each image includes:
  • The original image content.
  • Metadata (title, description, application, URL).
  • Available OCR data (if any).

Tools

• gyazo_search - Perform a full-text search on all captures uploaded by the user to Gyazo.
  • Search by keyword, title, application, URL, or time range.
  • Support paginated browsing of multiple results.
  • Return the URIs and metadata of matching images.
• gyazo_image - Retrieve the content and metadata of a specific image from Gyazo.
  • Retrieve a specific image using an ID or URL.
  • Return the image content and detailed metadata.
• gyazo_latest_image - Get the latest uploaded image from Gyazo.
  • Return the image content and metadata including OCR text (if any).
• gyazo_upload - Upload an image to Gyazo.
  • Upload using base64-encoded image data.
  • Optionally add metadata such as title, description, reference URL, and application name.
  • Return the permanent link URL and ID of the uploaded image.

📦 Installation

NPM Package

The simplest way to install the Gyazo MCP server is via NPM:

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

Prerequisites

• If you don't have a Gyazo account, sign up first: https://gyazo.com
• Obtain an API access token from Gyazo: https://gyazo.com/api
  • Click the "Register an application" button.
  • Click the "New application" button.
  • Fill out the form (name and callback URL are required).
    • Use http://localhost as the callback URL.
  • Click the "Submit" button.
  • Return to the application list and click on the application name to view details.
  • Scroll to the bottom and find "Your access token".
  • Click the "Generate" button.
  • Copy the value of "Your access token".
• Set the GYAZO_ACCESS_TOKEN environment variable to your token.

Claude Desktop Integration

To use it with Claude Desktop, add the server configuration: On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

Using the 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=your-access-token-here",
        "@notainc/gyazo-mcp-server"
      ]
    }
  }
}

🔧 Technical Details

• During development, use npm run dev to start the debug server.
• Use npm test for testing.