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。