AltText.ai MCP服务器
一 主控程序 服务器，允许AI助手生成alt文本、管理图像库，并使用 alttext.ai API
适用于Claude Desktop、Claude Code、Cursor、Windsurf和任何兼容MCP的客户端。
设置
要求： Node.js 18+和 AltText.ai API密钥
将服务器添加到MCP客户端配置中：
{
"mcpServers": {
"alttext-ai": {
"command": "npx",
"args": ["-y", "@alttext_ai/alttext-mcp"],
"env": {
"ALTTEXT_API_KEY": "your-api-key"
}
}
}
}在何处添加此内容：
| 客户端 | 配置文件 |
|---|---|
| 克劳德桌面 | claude_desktop_config.json |
| 克劳德代码 | .mcp.json 在项目根目录中 |
| 光标首选项中的光标 | MCP设置 |
| Windsurf | Windsurf首选项中的MCP设置 |
工具
账户管理
| 工具 | 说明 |
|---|---|
get_account | 检查您的信用余额、使用情况和帐户设置。 |
update_account | 更新帐户名、webhook URL或通知电子邮件。 |
生成Alt文本
| 工具 | 说明 |
|---|---|
generate_alt_text | 为图像URL生成alt文本。支持多语言输出、自定义提示、关键字和字符限制。费用1学分。 |
generate_alt_text_from_file | 从本地图像文件生成alt文本。自动进行base64编码和上传。费用1学分。 |
translate_image | 为现有图像添加新语言的alt文本（通过asset_id）。费用1学分。 |
管理图像库
| 工具 | 说明 |
|---|---|
list_images | 在库中列出带分页的图像。 |
search_images | 按alt文本内容搜索图像库。 |
get_image | 按资产ID获取特定图像的详细信息 |
update_image | 更新图像的alt文本、标签或元数据。 |
delete_image | 从库中删除图像。 |
批量操作
| 工具 | 说明 |
|---|---|
bulk_create | 使用图像URL和可选元数据从CSV文件批量生成alt文本。 |
scrape_page | 扫描网页，查找缺少alt文本的图像，并生成队列。结果是异步的--使用 list_images 检查进度。 |
示例提示
配置后，只需询问您的AI助手：
账户和信用
- “我还剩多少学分？”
- “将我的webhook URL更新为https://example.com/webhook"
生成Alt文本
- “为生成alt文本https://example.com/photo.jpg"
- “为此图像生成alt文本”（使用本地文件）
- “为此图像生成法语和西班牙语的alt文本”
- “将图像abc123翻译成德语”
管理库
- “在我的图片中搜索‘产品照片’”
- “列出我的图片”
- “获取图像abc123的详细信息”
- “更新资产abc123的alt文本”
- “删除图像xyz789”
批量操作
- “扫描https://example.com对于缺少alt文本的图像“
- “处理此CSV图像URL文件”（bulk_create）
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
ALTTEXT_API_KEY | 是 | 您的 AltText.ai API密钥 |
ALTTEXT_API_BASE_URL | 否 | 覆盖API基础URL（默认值： https://alttext.ai/api/v1) |
发展
npm install
npm run build
npm test
npm run lint测试使用模拟 fetch 调用--不需要API密钥或网络访问。
许可证
麻省理工学院