gyazo-mcp-server

gyazo-mcp-server

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

这是一个基于 TypeScript 的 MCP 服务，可访问 Gyazo 图片。它支持 AI 助手通过模型上下文协议访问和交互 Gyazo 图片，提供以下功能：

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

功能

资源

• 通过 gyazo-mcp:// URI 列出和访问 Gyazo 图片
• 每张图片均包含：
  • 原始图片内容
  • 元数据（标题、描述、应用、URL）
  • OCR 数据（如有）
• 支持各种图片格式（JPEG、PNG 等）

工具

• gyazo_search - 全文搜索用户上传到 Gyazo 的截图

  • 按关键词、标题、应用、URL 或日期范围搜索
  • 支持分页浏览多个结果
  • 返回匹配图片的 URI 和元数据

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

  • 按 ID 或 URL 获取指定图片
  • 返回图片内容和详细元数据

• gyazo_latest_image - 从 Gyazo 获取最新图片

  • 返回图片内容和元数据
  • 如有 OCR 文本，也会一并返回

• gyazo_upload - 上传图片到 Gyazo

  • 使用 base64 编码的图片数据上传图片
  • 添加可选元数据，如标题、描述、来源 URL 和应用名称
  • 返回已上传图片的永久链接 URL 和 ID

安装

NPM 包

安装 Gyazo MCP 服务最简单的方法是使用 npm：

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

前提条件

• 如果还没有 Gyazo 账户，请创建一个：https://gyazo.com
• 从此处获取 Gyazo API 访问令牌：https://gyazo.com/api
  • 点击“Register applications”按钮
  • 点击“New Application”按钮
  • 填写表单，输入应用名称和描述
    • 名称和回调 URL 为必填项
    • 回调 URL 可使用 http://localhost
  • 点击“Submit”按钮
  • 点击应用名称查看详情
  • 向下滚动到“Your Access Token”
  • 点击“Generate”按钮
  • 复制“Your access token”的值
• 设置 GYAZO_ACCESS_TOKEN 环境变量并填入令牌

Claude Desktop 集成

要在 Claude Desktop 中使用，请添加服务器配置：

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

使用 NPM 包（推荐）

{
  "mcpServers": {
    "gyazo-mcp-server": {
      "command": "npx",
      "args": ["@notainc/gyazo-mcp-server"],
      "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"
      }
    }
  }
}

开发

安装依赖：

npm ci

构建服务器：

npm run build

在开发过程中启用自动重新构建：

npm run watch

Docker 构建（可选）

npm run image:build

---