gyazo-mcp-server

gyazo-mcp-server

By nota GitHub

A Model Context Protocol server for Gyazo

Overview

what is gyazo-mcp-server?

The gyazo-mcp-server is a Model Context Protocol server designed for integrating Gyazo images, allowing AI assistants to access and interact with Gyazo images through a structured protocol.

how to use gyazo-mcp-server?

To use the gyazo-mcp-server, you need to set up a Gyazo account, obtain an API access token, and configure the server with the necessary environment variables. You can run the server locally or via Docker.

key features of gyazo-mcp-server?

  • Access to Gyazo images via gyazo-mcp:// URIs, including original content and metadata.
  • Fetch the latest image from Gyazo with the gyazo_latest_image tool, which returns image content and OCR data if available.
  • Supports various image formats like JPEG and PNG.

use cases of gyazo-mcp-server?

  1. Integrating Gyazo images into AI applications for enhanced visual content.
  2. Automating image retrieval and processing for data analysis.
  3. Enabling image-based interactions in chatbots and virtual assistants.

FAQ from gyazo-mcp-server?

  • How do I get my Gyazo API access token?

You can obtain your API access token by creating a Gyazo account and visiting the API section on their website.

  • Can I run the server in a Docker container?

Yes! The gyazo-mcp-server can be built and run using Docker for easier deployment.

  • What programming language is the server built with?

The server is built using TypeScript.

Content

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 fetching the latest image
  • 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_latest_image - Fetch the most recent image from Gyazo
    • Returns both 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

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

Docker

{
  "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. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

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

No tools information available.
No content found.