Gyazo MCP Server

🚀 gyazo-mcp-server

gyazo-mcp-server 是一个用于集成Gyazo图像的模型上下文协议（MCP）服务器。它基于TypeScript构建，允许AI助手通过Model Context Protocol交互访问和操作Gyazo图像，为用户提供了便捷的图像管理与使用体验。

🚀 快速开始

gyazo-mcp-server 是一个基于TypeScript构建的MCP服务器，专门用于提供对Gyazo图像的访问。它借助Model Context Protocol，让AI助手能够轻松地访问和操作Gyazo图像，涵盖通过特定URI表示图像资源、使用工具搜索与上传图像，以及借助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编码的图像数据进行上传，还能可选添加标题、描述、referrer URL和应用名称等元数据，最后返回上传图像的永久链接URL和ID。

📦 安装指南

NPM包

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

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

先决条件

• 若您还没有Gyazo账户，请先前往 Gyazo注册页面 进行注册。
• 获取您的Gyazo API访问令牌：
  1. 访问 Gyazo API页面。
  2. 点击“注册应用”按钮。
  3. 点击“新建应用”按钮。
  4. 填写表单，其中名称和回调URL为必填项，您可以使用 http://localhost 作为回调URL。
  5. 点击“提交”按钮。
  6. 点击应用查看详细信息。
  7. 向下滚动到“您的访问令牌”。
  8. 点击“生成”按钮。
  9. 复制“您的访问令牌”值。
• 设置环境变量 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

💻 使用示例

基础用法

以下是使用 gyazo_search 工具按关键词搜索图像的示例：

# 假设搜索关键词为 "example"
gyazo_search --keyword "example"

高级用法

以下是使用 gyazo_upload 工具上传图像并添加元数据的示例：

# 假设使用base64编码的图像数据存储在 image_data.txt 文件中
base64_image=$(cat image_data.txt)
gyazo_upload --image "$base64_image" --title "Example Image" --description "This is an example image" --referrer "http://example.com" --app "Example App"

📚 详细文档

开发

构建

1. 克隆仓库：

git clone <仓库地址>

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。