p4mcp-server — MCP-сервер для Claude Code: доступ к Perforce P4
Связывает ИИ-ассистента с Perforce P4: читает и меняет файлы, чейнджлисты, шелфы и рабочие пространства. Пригодится, если код лежит в P4, а не в Git.
Открыть на GitHubЧто делает p4mcp-server
Сервер построен на FastMCP с прямыми привязками к P4 Python и отдаёт ассистенту набор инструментов по файлам, чейнджлистам, шелфам, рабочим пространствам, задачам, ревью, стримам и метаданным сервера. Отдельно есть доступ к P4 DAM через REST API: поиск ассетов, их метаданные, теги, бандлы и проекты. Категории инструментов включаются по одной — server, files, changelists, shelves, workspaces, jobs, reviews, streams, p4dam.
По умолчанию сервер работает в режиме только для чтения. Удаление и obliterate требуют подтверждения через MCP elicitation (PROCEED/CANCEL), плюс есть проверки владения объектами. Логи пишутся в каталог logs/, телеметрия выключена и включается только с согласия.
Запустить можно без установки через uvx p4mcp-server, готовым бинарником или из исходников на Python 3.11+. Нужен доступ к серверу P4 и валидный логин — тикет или пароль. Для P4 DAM понадобится ключ P4DAM_API_KEY. Docker-вариант работает только на macOS и Linux.
Какие задачи решает
- посмотреть, что лежит в чейнджлисте, не открывая P4V
- собрать список файлов в шелфе перед отправкой на ревью
- проголосовать и оставить комментарий в P4 Code Review
- найти ассет в P4 DAM и обновить его теги
- проверить метаданные рабочего пространства и стрима
Примеры запросов агенту
- Покажи, какие файлы в моём текущем чейнджлисте
- Найди в P4 DAM ассеты по тегу
heroи выведи метаданные - Открой список ревью, где я участник, и покажи статусы голосов
Как установить p4mcp-server
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о p4mcp-server
Как установить p4mcp-server в Claude Code?
Готовой команды установки для Claude нет. Сервер запускают через uvx p4mcp-server, готовым бинарником или из исходников, а в mcp.json прописывают команду запуска и переменные окружения P4PORT, P4USER, P4CLIENT.
Что делает p4mcp-server?
Даёт ассистенту инструменты для работы с Perforce P4: файлы, чейнджлисты, шелфы, рабочие пространства, задачи, ревью, стримы и метаданные сервера. Дополнительно подключается к P4 DAM через REST API.
Какие есть требования для работы?
Нужен доступ к серверу P4 и валидный логин. Для P4 DAM — ключ P4DAM_API_KEY. Сборка из исходников требует Python 3.11+.
