AltText.ai MCP Server 是一个 MCP（模型上下文协议）服务器，旨在让 AI 助手通过 AltText.ai API 生成图像替代文本、管理图像库，并为网页图片排队生成替代文本。
用途：
- 在 AI 助手对话中直接生成和翻译图像 alt 文本。
- 管理 AltText.ai 图像库，包括搜索、列出、查看详情、更新和删除图像。
- 对网页进行无障碍审计，为缺失 alt 文本的图像批量生成替代文本。
主要能力：
- 账户管理：查看剩余积分、更新 webhook URL 等。
- 生成 Alt 文本：支持为指定图片 URL 或本地文件生成 alt 文本，支持指定语言、翻译已有 alt 文本。
- 图像库管理：搜索、列出、获取详情、更新、删除图像。
- 批量操作：处理包含图像 URL 的 CSV 文件，为网页缺失 alt 文本的图片批量生成。
- 效果与处理：生成和翻译消耗账户积分，额外语言和图像转换可能增加费用；生成时可覆盖现有 alt 文本；更新会替换提供的字段；删除会将图像从库中移除。
使用方式：
- 环境要求：Node.js 22+ 和 AltText.ai API 密钥。
- 在 MCP 客户端配置中添加服务器：使用 npx -y @alttext_ai/alttext-mcp。
- 支持 Claude Desktop、Claude Code、Cursor、Windsurf 等任何兼容 MCP 的客户端。
- 可通过 npm 包 @alttext_ai/alttext-mcp 安装；也可使用命令行工具 alttext（@alttext_ai/cli）进行账户管理和站点 API 密钥操作。
- 提供 skills/alttext 技能，可让 Claude Code、Codex 等编码代理驱动 alttext CLI，包含安全操作指导。
- 可通过 npx skills 添加技能，或作为 Claude Code 插件从仓库插件市场安装。
示例提示：
- "我还剩多少积分？"
- "为 https://example.com/photo.jpg 生成 alt 文本"
- "为这张图片生成法语和西班牙语的 alt 文本"
- "搜索我的图片中的 'product photo'"
- "为 https://example.com 上缺失 alt 文本的图片生成 alt 文本"
- "处理这个包含图像 URL 的 CSV 文件"
适用场景：
- 网站无障碍优化，批量补充图像 alt 文本。
- 多语言内容本地化，翻译图像 alt 文本。
- 图像资产管理，通过 AI 助手搜索、更新、删除图像库内容。
- 开发者工作流集成，通过 MCP 客户端或命令行工具自动化 alt 文本生成。
限制与注意事项：
- 生成和翻译使用账户积分，额外语言和图像转换可能增加总消耗；进行付费操作前建议检查 get_account。
- CSV 导入和页面抓取为后台队列处理，请求被接受不代表生成已完成，需检查图像库和配置的完成通知。
- 工具注释描述效果供客户端参考，但不强制执行确认。
- 该包使用 stdio，运行在启动 MCP 客户端的机器上；图像和 CSV 路径指向该机器；选定的文件内容会上传到 AltText.ai。
- npm 作用域为 @alttext_ai（带下划线），GitHub 组织为 alttextai（无下划线），这是有意为之，两者指向同一官方包。
- 可通过 npm audit signatures 验证包的加密来源，或固定特定版本以获得可复现的安装。
- 托管部署必须在受信任的边缘对 POST /register 进行速率限制，使用已验证的客户端地址；Node 服务刻意忽略转发的客户端地址头。
- 测试使用模拟的 fetch 调用，无需 API 密钥或网络访问。
