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, меняет стримы, голосует и комментирует ревью; синхронизация меняет локальные файлы.

Настройка клиентов

cursor
{
    "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.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Time

Эталонный сервер для получения текущего времени и перевода между часовыми поясами.

Риск: medium Лицензия: NOASSERTION ★ 92 089

Reactive Resume

Открытый конструктор резюме с удалёнными MCP-инструментами для резюме и откликов.

Риск: medium Лицензия: MIT ★ 45 567

AIHOT

Новости ИИ на китайском: темы, события и сводки.

Риск: medium Лицензия: MIT ★ 9 672

Источники