alttextgeneratorai-mcp

AltTextGeneratorAI MCP サーバー

AI アシスタントに、画像のSEO に適したアクセシブルな代替テキストを書いてもらったり、あらゆるウェブページで代替テキストがない画像を見つけたりできます。Shopify、WordPress、DatoCMS、Contentstack、Chrome など、30 以上のツールで使われている AI 代替テキストサービス、AltTextGeneratorAI.comと連携します。

アシスタントには、次のように頼むことができます。

• 「https://example.com/photo.jpg の代替テキストをスペイン語で書いてください。」
• 「~/Desktop/product.png の画像の代替テキストを書いてください。」
• 「https://mystore.com/products/shoes をスキャンして、代替テキストがない画像を教えてください。」
• 「そのページをスキャンして、代替テキストがない最初の 10 枚の画像に代替テキストを書いてください。」
• 「クレジットはあといくつ残っていますか？」

API キーを取得する

alttextgeneratorai.com/dashboardで無料アカウントを作成し、API キーをコピーしてください。新規アカウントには無料クレジットが付与されます。クレジットは一度だけ購入でき、有効期限はなく、すべての AltTextGeneratorAI 連携で共通して使用できます。

インストール

Node.js 18 以降が必要です。サーバーは必要に応じて npx で起動するため、手動でインストールする必要はありません。

Claude Desktop

Settings > Developer > Edit Configを開き、次の内容を追加してください。

{
  "mcpServers": {
    "alttextgeneratorai": {
      "command": "npx",
      "args": ["-y", "alttextgeneratorai-mcp"],
      "env": { "ALTTEXTGENERATORAI_API_KEY": "your_api_key" }
    }
  }
}

Claude Code

claude mcp add alttextgeneratorai --env ALTTEXTGENERATORAI_API_KEY=your_api_key -- npx -y alttextgeneratorai-mcp

Cursor

上記と同じ JSON を ~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）に追加してください。

VS Code

.vscode/mcp.json に追加してください。

{
  "servers": {
    "alttextgeneratorai": {
      "command": "npx",
      "args": ["-y", "alttextgeneratorai-mcp"],
      "env": { "ALTTEXTGENERATORAI_API_KEY": "your_api_key" }
    }
  }
}

stdio 経由の MCP サーバーに対応する他のクライアントも同様に動作します。ALTTEXTGENERATORAI_API_KEY 環境変数を設定して、npx -y alttextgeneratorai-mcp を実行してください。

ツール

ツール	内容	クレジット
generate_alt_text	公開 URL にある画像の代替テキストを書きます。language は省略可能です。	1
generate_alt_text_from_file	コンピューター上の画像ファイル（JPEG、PNG、GIF、WebP、最大 3 MB）の代替テキストを書きます。language は省略可能です。	1
audit_page	ウェブページを読み込み、alt 属性がない画像、または属性が空の画像を一覧表示します。無料です。generate: true を指定すると、それらの画像に対する代替テキスト案も作成します（max_images は最大 25、既定値は 5）。	0、または generate 指定時は画像 1 枚につき 1
check_credits	残りのクレジット数を表示します。	0

注意事項：

• **言語：**言語名は spanish、french、german、japanese のように英語で指定してください。130 以上の言語に対応しています。既定の言語は英語です。
• 空の代替テキスト（alt=""）は装飾のみを目的とする画像では正しい設定です。そのため、audit_page はこれらを、属性がない画像とは別に報告します。
• JavaScript で画像を読み込むページでは、ツールがページの HTML を読み込むため、検出される画像が少なくなる場合があります。
• このツールは読み取りと提案のみを行います。ウェブサイトを変更することはありません。提案されたテキストはご自身でサイトに追加するか、コード内で追加するようアシスタントに依頼してください。

設定

変数	必須	説明
ALTTEXTGENERATORAI_API_KEY	はい（生成とクレジット確認の場合）	API キーです。generate を指定しない audit_page は、キーなしで動作します。
ALTTEXTGENERATORAI_ALLOWED_DIR	いいえ	generate_alt_text_from_file に読み取りを許可するフォルダー（複数指定する場合は、Mac と Linux では :、Windows では ; で区切ります）。既定値はホームフォルダーと一時フォルダーです。
ALTTEXTGENERATORAI_API_BASE_URL	いいえ	API アドレスを上書きします（テスト用）。https、または localhost 上の http を指定してください。既定値は https://alttextgeneratorai.com/api です。

安全性

• audit_page は公開ウェブページのみを読み取ります。 localhost、192.168.x.x、10.x.x.x、クラウドメタデータアドレスなどのローカルアドレスやプライベートネットワークアドレスは、リダイレクト後も含めて拒否されます。アドレスは接続時に確認されるため、ホスト名が2回目の接続時に別の場所を指すことはありません。
• generate_alt_text_from_file は実際の画像のみを読み取り、許可されたフォルダー内の画像に限ります。 デフォルトでは、ホームフォルダーと一時フォルダーが許可されています。ALTTEXTGENERATORAI_ALLOWED_DIR で別のフォルダーを選択したり、1つのフォルダーに限定したりできます。ファイル名だけでなく、ファイルの内容も確認されます。
• API キーは環境変数から読み取られ、https 経由で AltTextGeneratorAI API にのみ送信され、ログに記録されることはありません。カスタム API アドレスには https を使用する必要があります。
• エラーメッセージは簡潔で、生の技術的な出力は含まれません。

プライバシー

代替テキストを作成するため、サーバーは API キー、選択した言語、画像の公開アドレスまたは画像ファイルを AltTextGeneratorAI.com に送信します。画像アドレスを指定した場合（audit_page と generate: true を使用する場合を含む）、AltTextGeneratorAI サービスがその画像をダウンロードして説明します。公開ウェブアドレスのみ受け付けます。audit_page は、確認を依頼されたページをお使いのコンピューターから直接ダウンロードします。それ以外の情報は送信されません。プライバシーポリシーをご覧ください。

開発

npm install
npm run build
npm test      # runs the server over stdio against a fake API

サポート

[email protected] · alttextgeneratorai.com

ライセンス

MIT