gyazo-mcp-server

Gyazo图片集成为Model Context Protocol（MCP）服务器

这是一个基于TypeScript构建的MCP服务器，提供对Gyazo图像的访问。它允许AI助手通过模型上下文协议访问和交互使用Gyazo图像，包括：

• 通过gyazo-mcp:// URI及其元数据表示Gyazo图片
• 提供搜索、获取和上传图片的功能
• 通过Gyazo API访问图片内容和元数据

功能

资源

• 列出并访问使用gyazo-mcp:// URI的Gyazo图片
• 每张图片包括：
  • 原始图片内容
  • 元数据（标题、描述、应用、URL）
  • 可用的OCR数据（如果有）

工具

• gyazo_search - 对用户在Gyazo上传的所有捕获进行全文搜索

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

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

  • 使用ID或URL检索特定图片
  • 返回图片内容和详细元数据

• gyazo_latest_image - 获取Gyazo最新上传的图片

  • 返回包含OCR文本（如果有）的图片内容和元数据

• gyazo_upload - 将图片上传到Gyazo

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

安装

NPM包

通过NPM安装Gyazo MCP服务器最简单的方式：

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

先决条件

• 如果没有Gyazo账户，请先注册：https://gyazo.com
• 从Gyazo获取API访问令牌：https://gyazo.com/api
  • 点击“注册应用”按钮
  • 点击“新建应用”按钮
  • 填写表单（名称和回调URL为必填）
    • 使用http://localhost作为回调URL
  • 点击“提交”按钮
  • 返回到应用列表，点击应用名称查看详细信息
  • 滚动到底部，找到“您的访问令牌”
  • 点击“生成”按钮
  • 复制“您的访问令牌”的值
• 设置GYAZO_ACCESS_TOKEN环境变量为您的令牌

Claude Desktop集成

要与Claude桌面一起使用，请添加服务器配置：

在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=your-access-token-here",
        "@notainc/gyazo-mcp-server"
      ]
    }
  }
}

开发

• 在开发过程中，使用npm run dev启动调试服务器
• 使用npm test进行测试