image-recognition-mcp — MCP-сервер для Claude Code: что делает
Передаёт моделям OpenAI ссылки на графические файлы и возвращает текстовые описания. Пригодится, когда ассистенту в терминале или редакторе нужно распознать содержимое иллюстрации.
claude mcp add image-recognition-mcp -e OPENAI_API_KEY=<OPENAI_API_KEY> -- npx -y image-recognition-mcpЧто делает image-recognition-mcp
Сервер добавляет инструмент describe-image, который принимает параметр imageUrl. Модель технического зрения OpenAI обрабатывает файл по указанному адресу и формирует отчёт о том, что на нём изображено.
Внутри проект написан на TypeScript и собран в пакет для запуска через npx. Для работы требуются Node.js версии 18 или новее и ключ OPENAI_API_KEY с доступными кредитами на балансе.
Без переменной окружения OPENAI_API_KEY сервер не сможет авторизоваться и ответит ошибкой. Обработка ошибок в коде также перехватывает сбои сети и некорректные адреса ссылок.
Какие задачи решает
- получить текстовое описание графического файла по веб-адресу
- подключить зрение OpenAI к ассистентам без встроенной обработки картинок
- разобрать визуальный контекст внешнего скриншота через
describe-image
Примеры запросов агенту
- Опиши, что находится на изображении: <imageUrl>
- Вызови
describe-imageдля иллюстрации по ссылке <imageUrl> - Посмотри на картинку по адресу <imageUrl> и перескажи её детали
Как установить image-recognition-mcp
Командой платформы
claude mcp add image-recognition-mcp -e OPENAI_API_KEY=<OPENAI_API_KEY> -- npx -y image-recognition-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add image-recognition-mcp --env OPENAI_API_KEY=<OPENAI_API_KEY> -- npx -y image-recognition-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"image-recognition-mcp": {
"command": "npx",
"args": [
"-y",
"image-recognition-mcp"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"image-recognition-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"image-recognition-mcp"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e OPENAI_API_KEY=<OPENAI_API_KEY> image-recognition-mcp npx -y image-recognition-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о image-recognition-mcp
Как установить image-recognition-mcp в Claude Code?
Выполните команду claude mcp add image-recognition-mcp -e OPENAI_API_KEY=<OPENAI_API_KEY> -- npx -y image-recognition-mcp. Вместо <OPENAI_API_KEY> подставьте действующий ключ доступа.
Что делает image-recognition-mcp?
Он предоставляет инструмент describe-image, отправляющий веб-ссылку на картинку в модели компьютерного зрения OpenAI для получения подробного описания.
Что нужно подготовить перед запуском сервера?
Потребуются установленная среда Node.js от 18 версии и рабочий ключ OpenAI с активным балансом в переменной окружения OPENAI_API_KEY.
