mcp · phototology-ai — MCP-сервер для Claude Code: реестр фотоанализа
Постоянная память для визуального анализа: фото распознаётся один раз, а повторные обращения к нему бесплатны. Пригодится агентам, которые читают одни и те же снимки.
claude mcp add --env PHOTOTOLOGY_API_KEY=<PHOTOTOLOGY_API_KEY> --env PHOTOTOLOGY_BASE_URL=<PHOTOTOLOGY_BASE_URL> --env PHOTOTOLOGY_MCP_NO_TELEMETRY=<PHOTOTOLOGY_MCP_NO_TELEMETRY> --env DO_NOT_TRACK=<DO_NOT_TRACK> --env PHOTOTOLOGY_MCP_ALLOWED_DIRS=<PHOTOTOLOGY_MCP_ALLOWED_DIRS> --transport stdio mcp -- npx -y @phototology/mcpЧто делает mcp
Это MCP-сервер от Phototology, который подключает агента к реестру изображений. Первый анализ фото списывает 1 кредит за каждую линзу, а дальше результат отдаётся бесплатно — запись хранится по perceptual hash и sha256, поэтому повторный вызов на тот же снимок ничего не стоит. Запускается через npx -y @phototology/mcp, работает по stdio.
Внутри 7 инструментов. lookup_photo проверяет, есть ли фото в реестре, analyze_photo разбирает одну картинку по линзам, analyze_batch берёт от 1 до 200 снимков за раз, enrich_photo записывает результат в EXIF, IPTC и XMP файла. Ещё три бесплатных помощника: list_lenses, get_credits и purchase_credits. Перед большим прогоном стоит вызвать analyze_batch с dryRun: true — так видно стоимость без списания.
Без ключа PHOTOTOLOGY_API_KEY сервер не заработает: каждый вызов анализа уходит на hosted API Phototology, локальной модели нет. Идентификацию людей сервер не делает — линза people считает головы и описывает внешность, но не сопоставляет лица. Подписи C2PA тоже нет: formats: ["c2pa"] отклоняется.
Какие задачи решает
- переиспользовать один и тот же разбор фото между вызовами агента
- узнать стоимость батча до его запуска
- записать структурированные поля снимка прямо в метаданные файла
- найти дубликаты по perceptual hash
- получить даты, текст и локацию с фото в виде JSON, а не прозы
Примеры запросов агенту
- Проверь через
lookup_photo, есть ли это фото в реестре, прежде чем анализировать - Разбери папку снимков через
analyze_batchсdryRun: trueи покажи, сколько это будет стоить - Запиши результат анализа в EXIF файла
photo.jpgчерезenrich_photo
Как установить mcp
Командой платформы
claude mcp add --env PHOTOTOLOGY_API_KEY=<PHOTOTOLOGY_API_KEY> --env PHOTOTOLOGY_BASE_URL=<PHOTOTOLOGY_BASE_URL> --env PHOTOTOLOGY_MCP_NO_TELEMETRY=<PHOTOTOLOGY_MCP_NO_TELEMETRY> --env DO_NOT_TRACK=<DO_NOT_TRACK> --env PHOTOTOLOGY_MCP_ALLOWED_DIRS=<PHOTOTOLOGY_MCP_ALLOWED_DIRS> --transport stdio mcp -- npx -y @phototology/mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp --env PHOTOTOLOGY_API_KEY=<PHOTOTOLOGY_API_KEY> --env PHOTOTOLOGY_BASE_URL=<PHOTOTOLOGY_BASE_URL> --env PHOTOTOLOGY_MCP_NO_TELEMETRY=<PHOTOTOLOGY_MCP_NO_TELEMETRY> --env DO_NOT_TRACK=<DO_NOT_TRACK> --env PHOTOTOLOGY_MCP_ALLOWED_DIRS=<PHOTOTOLOGY_MCP_ALLOWED_DIRS> -- npx -y @phototology/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@phototology/mcp"
],
"env": {
"PHOTOTOLOGY_API_KEY": "<PHOTOTOLOGY_API_KEY>",
"PHOTOTOLOGY_BASE_URL": "<PHOTOTOLOGY_BASE_URL>",
"PHOTOTOLOGY_MCP_NO_TELEMETRY": "<PHOTOTOLOGY_MCP_NO_TELEMETRY>",
"DO_NOT_TRACK": "<DO_NOT_TRACK>",
"PHOTOTOLOGY_MCP_ALLOWED_DIRS": "<PHOTOTOLOGY_MCP_ALLOWED_DIRS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@phototology/mcp"
],
"env": {
"PHOTOTOLOGY_API_KEY": "<PHOTOTOLOGY_API_KEY>",
"PHOTOTOLOGY_BASE_URL": "<PHOTOTOLOGY_BASE_URL>",
"PHOTOTOLOGY_MCP_NO_TELEMETRY": "<PHOTOTOLOGY_MCP_NO_TELEMETRY>",
"DO_NOT_TRACK": "<DO_NOT_TRACK>",
"PHOTOTOLOGY_MCP_ALLOWED_DIRS": "<PHOTOTOLOGY_MCP_ALLOWED_DIRS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e PHOTOTOLOGY_API_KEY=<PHOTOTOLOGY_API_KEY> -e PHOTOTOLOGY_BASE_URL=<PHOTOTOLOGY_BASE_URL> -e PHOTOTOLOGY_MCP_NO_TELEMETRY=<PHOTOTOLOGY_MCP_NO_TELEMETRY> -e DO_NOT_TRACK=<DO_NOT_TRACK> -e PHOTOTOLOGY_MCP_ALLOWED_DIRS=<PHOTOTOLOGY_MCP_ALLOWED_DIRS> mcp npx -y @phototology/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp
Как установить mcp в Claude Code?
Одной командой: claude mcp add mcp -e PHOTOTOLOGY_API_KEY=<PHOTOTOLOGY_API_KEY> -- npx -y @phototology/mcp. Ключ подставьте свой.
Что делает mcp?
Подключает агента к реестру Phototology: фото анализируется один раз, а повторные обращения к нему возвращаются из кеша бесплатно. Отдаёт структурированные поля по линзам.
Нужен ли интернет и ключ API?
Да, оба. Локальной модели у сервера нет, каждый вызов анализа идёт на hosted API Phototology, поэтому без PHOTOTOLOGY_API_KEY он не запустится.
Похожие MCP-серверы
Все MCP-серверы по теме «Настройка агента: память, контекст, субагенты» →Сначала — mcp от других авторов.
