Gyazo MCP Server

by nota
MIT License
10
  • Apple

Integrations

  • Implemented as a TypeScript-based MCP server that provides access to Gyazo images and their metadata

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

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

-
security - not tested
A
license - permissive license
-
quality - not tested

A TypeScript-based MCP server that enables AI assistants to interact with Gyazo images using the Model Context Protocol, providing access to image URIs, metadata, and OCR data via the Gyazo API.

  1. Features
    1. Resources
    2. Tools
  2. Installation
    1. NPM Package
    2. Prerequisites
    3. Claude Desktop Integration
  3. Development
    1. Docker Build (optional)

Related MCP Servers

  • -
    security
    A
    license
    -
    quality
    A simple MCP server for interacting with OpenAI assistants. This server allows other tools (like Claude Desktop) to create and interact with OpenAI assistants through the Model Context Protocol.
    Last updated -
    18
    Python
    MIT License
    • Apple
  • -
    security
    A
    license
    -
    quality
    A TypeScript-based MCP server that provides two tools for chatting with Mistral AI models, supporting both text-only conversations and image+text inputs.
    Last updated -
    JavaScript
    MIT License
    • Apple
  • A
    security
    F
    license
    A
    quality
    A TypeScript-based MCP server that generates images using OpenAI's dall-e-3 model based on text prompts and saves them to a specified directory.
    Last updated -
    1
    6
    JavaScript
    • Apple
  • A
    security
    A
    license
    A
    quality
    An MCP (Model Context Protocol) server that integrates with the ArgoCD API, enabling AI assistants and large language models to manage ArgoCD applications and resources through natural language interactions.
    Last updated -
    10
    6
    Python
    MIT License
    • Linux
    • Apple

View all related MCP servers

ID: bhrk879agk