# p4mcp-server

Связывает ИИ-ассистента с Perforce P4: читает и меняет файлы, чейнджлисты, шелфы и рабочие пространства. Пригодится, если код лежит в P4, а не в Git.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 123
- Автор: perforce
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/perforce/p4mcp-server
- Обновлён: 2026-09-25
- HTML: https://affpapa.org/nevibecode/mcp/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.

## Установка

### Claude Code (родная платформа)

**Установка**
- Команды запуска нет в реестре MCP — смотрите README репозитория

## Когда брать
- посмотреть, что лежит в чейнджлисте, не открывая P4V
- собрать список файлов в шелфе перед отправкой на ревью
- проголосовать и оставить комментарий в P4 Code Review
- найти ассет в P4 DAM и обновить его теги
- проверить метаданные рабочего пространства и стрима

## Примеры запросов агенту
- Покажи, какие файлы в моём текущем чейнджлисте
- Найди в P4 DAM ассеты по тегу `hero` и выведи метаданные
- Открой список ревью, где я участник, и покажи статусы голосов

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [GitDiagram](https://affpapa.org/nevibecode/mcp/gitdiagram.md) — MCP-сервер · ★ 18446
- [Repowise](https://affpapa.org/nevibecode/mcp/repowise.md) — MCP-сервер · ★ 7891
- [sem](https://affpapa.org/nevibecode/mcp/sem.md) — MCP-сервер · ★ 3422
- [GitLab MCP Server](https://affpapa.org/nevibecode/mcp/gitlab-mcp-server.md) — MCP-сервер · ★ 2065
- [Octocode MCP - AI Context Platform](https://affpapa.org/nevibecode/mcp/octocode-mcp-ai-context-platform.md) — MCP-сервер · ★ 955

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md