NG

nota/gyazo-mcp-server

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

28 stars 12 forks 质量 83 趋势 31MIT

Gyazo 官方模型上下文协议服务器

概览

用于 Gyazo 图像集成的模型上下文协议服务器 这是一个基于TypeScript的MCP服务器,提供对Gyazo图像的访问。它允许AI助手通过模型上下文协议访问和交互Gyazo图像,提供: - 含 URI 和元数据的 Gyazo 图像资源 - 用于搜索、获取和上传图像的工具 - 通过 Gyazo API 访问图像内容和元数据 - 通过gyazo-mcp:// URIs列表和访问Gyazo 图片 - 每张图片包含:- 原始图片内容 - 元数据(标题、描述、应用、URL)- OCR数据(如有)- 支持多种图片格式(JPEG、PNG等)

概述(AI 翻译)

用于 Gyazo 图像集成的模型上下文协议服务器

这是一个基于TypeScript的MCP服务器,提供对Gyazo图像的访问。它允许AI助手通过模型上下文协议访问和交互Gyazo图像,提供:

  • 表示Gyazo图像的资源,包含URI和元数据
  • 用于搜索、获取和上传图片的工具
  • 通过Gyazo API访问图像内容和元数据

特色

资源

  • 通过gyazo-mcp://URI列表和访问Gyazo图像
  • 每张图片包括:
  • 原始图片内容
  • 元数据(标题、描述、应用、URL)
  • OCR数据(如有)
  • 支持多种图像格式(JPEG、PNG 等)

工具

  • gyazo_search - 用户在Gyazo上传的捕获内容的全文搜索

  • 通过关键词、标题、应用、网址或日期范围搜索

  • 支持分页浏览多个结果

  • 返回匹配的图像URI和元数据

  • gyazo_image - 从Gyazo获取图像内容和元数据

  • 通过ID或URL检索特定图片

  • 返回图像内容和详细元数据

  • gyazo_latest_image - 获取Gyazo的最新图像

  • 返回图像内容和元数据

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

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": {
在 GitHub 查看完整 README

安装

npx @notainc/gyazo-mcp-server
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "gyazo-mcp-server": { "command": "npx", "args": ["@notainc/gyazo-mcp-server"], "env": { "GYAZO_ACCESS_TOKEN": "your-access-token-here" } } } }