Gyazo MCP Server

🚀 gyazo-mcp-server

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

• gyazo-mcp:// URIとそのメタデータで表されるGyazo画像リソース
• 画像の検索、取得、アップロードツール
• Gyazo APIを通じた画像コンテンツとメタデータの取得

🚀 クイックスタート

このサーバーを使用することで、AIアシスタントはGyazo画像にアクセスし、操作することが可能です。具体的には、gyazo-mcp:// URIを用いて画像を列挙・アクセスしたり、各種ツールを使って画像を検索、取得、アップロードしたりすることができます。

✨ 主な機能

リソース

• 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
  • 「アプリを登録」ボタンをクリックします。
  • 「新しいアプリを作成」ボタンをクリックします。
  • フォームを記入します。名前とコールバックURLは必須項目です。
    • コールバックURLとしてhttp://localhostを使用できます。
  • 「送信」ボタンをクリックします。
  • アプリの詳細を表示するためにアプリをクリックします。
  • 「あなたのアクセストークン」までスクロールします。
  • 「生成」ボタンをクリックします。
  • 「あなたのアクセストークン」の値をコピーします。
• 環境変数 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

🔧 技術詳細

ビルド

1. リポジトリをクローンします。
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を参照してください。