gyazo-mcp-server

gyazo-mcp-server

Gyazo 画像連携のための Model Context Protocol サーバー

これは Gyazo 画像へのアクセスを提供する TypeScript ベースの MCP サーバーです。AI アシスタントが Model Context Protocol を通じて Gyazo 画像にアクセスし操作できるようにし、以下を提供します：

• URI とメタデータを持つ Gyazo 画像を表すリソース
• 画像の検索、取得、アップロードのためのツール
• 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 エンコードされた画像データで画像をアップロード
  • タイトル、説明、リファラー URL、アプリ名などのオプションのメタデータを追加
  • アップロードされた画像のパーマリンク URL と ID を返します

インストール

NPM パッケージ

Gyazo MCP サーバーをインストールする最も簡単な方法は npm 経由です：

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

前提条件

• アカウントをお持ちでない場合は Gyazo アカウントを作成してください：https://gyazo.com
• Gyazo API アクセストークンを取得してください：https://gyazo.com/api
  • 「Register applications」ボタンをクリック
  • 「New Application」ボタンをクリック
  • アプリ名と説明をフォームに入力
    • 名前と Callback URL は必須です
    • Callback URL には http://localhost を使用できます
  • 「Submit」ボタンをクリック
  • アプリケーション名をクリックして詳細を表示
  • 「Your Access Token」までスクロールダウン
  • 「Generate」ボタンをクリック
  • 「Your access token」の値をコピー
• GYAZO_ACCESS_TOKEN 環境変数にトークンを設定してください

Claude Desktop 統合

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 を使用する場合（オプション）

{
  "mcpServers": {
    "gyazo-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GYAZO_ACCESS_TOKEN",
        "gyazo-mcp-server"
      ],
      "env": {
        "GYAZO_ACCESS_TOKEN": "your-access-token-here"
      }
    }
  }
}

開発

依存関係をインストール：

npm ci

サーバーをビルド：

npm run build

自動再ビルドでの開発の場合：

npm run watch

Docker ビルド（オプション）

npm run image:build

---