Gyazo

🚀 gyazo-mcp-server

Gyazo画像コレクションをModel Context Protocol（MCP）サーバーに統合します。

このサーバーは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は必須）
    • コールバックURLにはhttp://localhostを使用します。
  • 「送信」ボタンをクリックします。
  • アプリ一覧に戻り、アプリ名をクリックして詳細を表示します。
  • ページの最下部までスクロールし、「あなたのアクセストークン」を見つけます。
  • 「生成」ボタンをクリックします。
  • 「あなたのアクセストークン」の値をコピーします。
• 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を使用してテストを行います。