🚀 gyazo-mcp-server

Gyazo图片集成为Model Context Protocol（MCP）服务器，此项目基于TypeScript构建，能让AI助手借助模型上下文协议对Gyazo图像进行访问与交互，为图像的使用提供了便捷途径。

🚀 快速开始

这是一个基于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进行测试。