alttextgeneratorai-mcp

AltTextGeneratorAI MCP 服务

让你的 AI 助手为图片撰写符合 SEO 要求且无障碍的替代文本，并找出任意网页上缺少替代文本的图片。它与 AltTextGeneratorAI.com 配合使用。这项 AI 替代文本服务已用于 Shopify、WordPress、DatoCMS、Contentstack、Chrome 等 30 多种工具。

你可以向助手提出这样的要求：

• “为 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

打开 设置 > 开发者 > 编辑配置，并添加：

{
  "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 服务的其他客户端也同样适用：运行 npx -y alttextgeneratorai-mcp，并设置 ALTTEXTGENERATORAI_API_KEY 环境变量。

工具

工具	功能	积分
generate_alt_text	为公开 URL 上的图片撰写替代文本。可选参数 language。	1
generate_alt_text_from_file	为你电脑上的图片文件撰写替代文本（JPEG、PNG、GIF 或 WebP，最大 3 MB）。可选参数 language。	1
audit_page	读取网页并列出没有 alt 属性或 alt 属性为空的图片。免费。设置 generate: true 后，也会为这些图片撰写建议的替代文本（max_images 最多为 25，默认为 5）。	0，或启用 generate 时每张图片 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、云元数据地址）都会被拒绝，包括重定向后的地址。连接建立时会检查地址，因此主机名不能在第二次连接时指向其他位置。
• generate_alt_text_from_file 只读取真实图像，且仅限允许的文件夹。 默认包括你的主文件夹和临时文件夹。使用 ALTTEXTGENERATORAI_ALLOWED_DIR 可选择其他文件夹，或将范围缩小到一个文件夹。系统会检查文件内容，而不只是文件名。
• 你的 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