p4mcp-server
p4mcp-server — MCP-сервер сообщества (автор — perforce). Официальный сервер Perforce P4 для системы контроля версий. Ставится через uvx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- perforce
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- token_env
- ОС
- Не указана
- Языки
- python
Уровень риска: high
Без --readonly редактирует, удаляет и перемещает файлы в P4, меняет стримы, голосует и комментирует ревью; синхронизация меняет локальные файлы.
Настройка клиентов
{
"code": "{\n \"mcpServers\": {\n \"perforce-p4-mcp\": {\n \"command\": \"/absolute/path/to/p4-mcp-server\",\n \"env\": {\n \"P4PORT\": \"ssl:perforce.example.com:1666\",\n \"P4USER\": \"your_username\",\n \"P4CLIENT\": \"your_workspace\",\n \"P4DAM_API_KEY\": \"your_api_key\"\n },\n \"args\": [\n \"--readonly\", \"--allow-usage\"\n ]\n }\n }\n}",
"lang": "json",
"notes": "Дословно из README",
"verified": "docs"
}
Что умеет
Perforce P4 MCP Server — официальный MCP-сервер Perforce для системы контроля версий P4. Он построен на FastMCP и прямых Python-привязках P4 и даёт ассистенту структурированные инструменты чтения и записи для чейнджлистов, файлов, шелвов, рабочих пространств, задач (jobs), ревью, стримов и информации о сервере. Отдельно поддерживается P4 DAM — система управления цифровыми ассетами.
Инструменты чтения: query_server, query_workspaces, query_changelists, query_files (содержимое ревизии, история, diff, аннотации с blame, поиск по имени и по содержимому), query_shelves, query_jobs, query_reviews, query_streams, а также поиск ассетов, проектов, репозиториев, ревью и воркфлоу P4 DAM.
Инструменты записи: modify_workspaces, modify_changelists, modify_files (add, edit, delete, move, revert, reconcile, resolve, sync), modify_shelves, modify_jobs, modify_reviews (голосование, смена статуса, участники, комментарии), modify_streams, а также создание и синхронизация бандлов ассетов, ревью, теги, комментарии и атрибуты в P4 DAM.
Безопасность. По умолчанию сервер работает только на чтение; есть проверки владения и интерактивное подтверждение (PROCEED или CANCEL) для удаления и obliterate. Флаг --toolsets включает только нужные категории (files, changelists, shelves, workspaces, jobs, reviews, streams, p4dam). Администратор может глобально или по группам и пользователям ограничить наборы инструментов, запись и отдельные инструменты через свойства сервера P4. --search-transform включает поиск по инструментам, чтобы не отправлять клиенту весь каталог.
Сервер ведёт логи в каталоге logs/, работает на macOS, Linux и Windows.
Кому подойдёт
- Игровым студиям и командам с большими репозиториями на Perforce.
- Разработчикам, которым нужны история файлов, diff и ревью P4 Code Review прямо в ассистенте.
- Администраторам P4, которые хотят дать ИИ безопасный доступ с политиками по группам.
Похожие серверы — в категории разработка.
Установка
Нужен доступ к серверу P4 (проверялась версия 2026.1) и действующий вход по тикету или паролю. Варианты: uvx p4mcp-server без установки (нужен uv), готовые бинарники для macOS, Windows и Linux (подходят для изолированных сетей), сборка из исходников (Python 3.11+) или Docker-образ ghcr.io/perforce/p4mcp-server. Есть и HTTP-режим (--transport http); по умолчанию он слушает только 127.0.0.1.
Переменные: P4PORT (адрес сервера), P4USER, P4CLIENT (рабочее пространство, желательно) и P4DAM_API_KEY для P4 DAM. В поле command используйте абсолютный путь.
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
{
"mcpServers": {
"perforce-p4-mcp": {
"command": "uvx",
"args": [
"p4mcp-server",
"--readonly", "--allow-usage"
],
"env": {
"P4PORT": "ssl:perforce.example.com:1666",
"P4USER": "your_username",
"P4CLIENT": "your_workspace",
"P4DAM_API_KEY": "your_api_key"
}
}
}
}Конфиг Cursor с бинарником README приводит также для Windsurf и Kiro, а для Claude Code — и вариант с бинарником. Флаг --allow-usage разрешает анонимную статистику использования; уберите его, если она не нужна. Без --readonly включается запись.
Проверка
Спросите: «Покажи информацию о сервере P4 и текущем пользователе» — сработает query_server.
Примеры задач
Покажи последние 10 отправленных чейнджлистов в //depot/main и кратко опиши изменения.Найди ревью, ожидающие моего голоса, и покажи diff по каждому.Риски
- Запись в репозиторий. Без
--readonlyсервер редактирует, удаляет и перемещает файлы, создаёт чейнджлисты и меняет стримы — начинайте с режима только чтения. - Локальные файлы. Синхронизация и reconcile меняют файлы в рабочем пространстве.
- Ревью от вашего имени. Голоса, комментарии и смены статуса публикуются от вашей учётной записи.
- Учётные данные. Тикет P4 и ключ P4 DAM хранятся в конфиге; не публикуйте их.
- HTTP-режим. При
--host 0.0.0.0сервер доступен без аутентификации — только в доверенных сетях.
Частые вопросы
Включена ли запись по умолчанию?
README рекомендует флаг --readonly; без него запись включается при наличии прав на сервере P4.
Собирает ли сервер статистику?
Только с флагом --allow-usage; содержимое и имена файлов не собираются.
Можно ли ограничить ИИ по группам?
Да, администратор задаёт политики через свойства сервера P4.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
Everything
Эталонный тестовый сервер, который демонстрирует все возможности протокола MCP.
Time
Эталонный сервер для получения текущего времени и перевода между часовыми поясами.
Reactive Resume
Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.
AIHOT
Новости ИИ на китайском: темы, события и сводки.