# p4mcp-server

Wires your AI assistant into Perforce P4: files, changelists, shelves and workspaces. Useful when the code lives in P4 instead of Git.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 123
- Author: perforce
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/perforce/p4mcp-server
- Updated: 2026-09-25
- HTML: https://affpapa.org/en/nevibecode/mcp/p4mcp-server

## What it does

The server runs on FastMCP with direct P4 Python bindings and hands the assistant tools for files, changelists, shelves, workspaces, jobs, reviews, streams and server metadata. A separate piece talks to P4 DAM over its REST API: asset search, metadata, tags, bundles and projects. Tool categories are switched on individually — server, files, changelists, shelves, workspaces, jobs, reviews, streams, p4dam.

Read-only is the default. Destructive delete and obliterate operations go through MCP elicitation with PROCEED/CANCEL, and ownership checks sit alongside. Logs land in the `logs/` directory; telemetry is off unless you consent to it.

You can start it without installing anything via `uvx p4mcp-server`, or use a pre-built binary, or build from source with Python 3.11+. A P4 server connection and a valid login (ticket or password) are required. P4 DAM access needs a `P4DAM_API_KEY`. The Docker route is macOS and Linux only.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- inspect what sits in a changelist without opening P4V
- list the files in a shelf before sending it to review
- vote and comment on a P4 Code Review
- find a P4 DAM asset and update its tags
- check workspace and stream metadata

## Example prompts
- Show me the files in my current changelist
- Search P4 DAM for assets tagged `hero` and print their metadata
- List the reviews I'm a participant in and show the vote states

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

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md