Gyazo 이미지 통합을 위한 모델 Context Protocol 서버

Gyazo 이미지에 액세스 할 수있는 TypeScript 기반 MCP 서버입니다. AI Assistants는 Model Context Protocol을 통해 Gyazo 이미지에 액세스하고 상호 작용할 수 있습니다.

• URI와 metadata를 가진 Gyazo 이미지를 나타내는 자원
• 검색, fetching 및 업로드 이미지 도구
• Gyazo API를 통한 이미지 콘텐츠 및 메타데이터 액세스

특징

자원

• gyazo-mcp://를 통해 Gyazo 이미지 목록 및 액세스 한국어
• 각 이미지는 다음을 포함합니다:
• 원문
• 메타데이터 (제목, 설명, 앱, URL)
• OCR 자료 (유효한 경우에)
• 다양한 이미지 형식 지원 (JPEG, PNG 등)

도구

• gyazo_search - Gyazo의 사용자에 의해 업로드 캡처의 전체 텍스트 검색

• 키워드, 제목, 앱, URL 또는 날짜 범위로 검색

• 여러 결과 검색을위한 pagination 지원

• 일치하는 이미지 URI 및 metadata 반환

• gyazo_image - Gyazo의 이미지 내용과 메타데이터

• ID 또는 URL로 특정 이미지를 검색

• 이미지 내용과 상세한 메타데이터를 모두 반환합니다.

• gyazo_latest_image - Gyazo에서 가장 최근의 이미지를 Fetch

• 이미지 내용과 메타데이터를 모두 반환

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