Gyazo

🚀 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進行測試。