gyazo-mcp-server

一个用于集成Gyazo图像的模型上下文协议（MCP）服务器。

这是一个基于TypeScript构建的MCP服务器，提供对Gyazo图像的访问。它允许AI助手通过Model Context Protocol交互访问和操作Gyazo图像，包括：

• 通过 gyazo-mcp:// URI及其元数据表示的Gyazo图像资源
• 搜索、获取和上传图像的工具
• 通过Gyazo API获取图像内容及元数据

功能

资源

• 列举并访问Gyazo图像，使用 gyazo-mcp:// URI
• 每张图像包括：
  • 原始图像内容
  • 元数据（标题、描述、应用、URL）
  • OCR数据（若有可用）
• 支持多种图像格式（JPEG、PNG等）

工具

• gyazo_search：按全文搜索用户在Gyazo上传的捕获

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

• gyazo_image：从Gyazo获取图像内容及元数据

  • 按ID或URL检索特定图像
  • 返回图像内容及详细元数据

• gyazo_latest_image：获取Gyazo最新的图像

  • 返回图像内容及元数据
  • 包含可用的OCR文本

• gyazo_upload：向Gyazo上传图像

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

安装

NPM包

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

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桌面集成

要与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

docker run -it --rm -p 3000:3000 -e GYAZO_API_KEY=your_access_token_here notational/gyazo-mcp-server

开发

构建

1. 克隆仓库：
2. 安装依赖：

npm install

3. 运行开发服务器：

npm run dev

脚本

• npm run dev：在开发模式下运行服务器
• npm run build：构建生产版本
• npm run test：运行测试
• npm run lint：执行代码检查

Docker

要使用Docker，请参考notational/gyazo-mcp-server。