P4mcp Server
MCP server giving AI assistants structured access to Perforce P4 version control
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Version
- 2025.1.2830393
- Listing updated
- today
Similar MCP servers
About P4mcp Server
P4mcp Server is an open-source MCP server for developer tools. It is available on CLI, Linux, macOS, Windows, self-hosted and API.
The README describes this as a Model Context Protocol server that connects AI clients to Perforce P4 depots. It is built on FastMCP and uses direct P4 Python bindings, exposing query and modify tools for changelists, files, shelves, workspaces, jobs, code reviews, streams and server metadata. Write operations are on by default unless the server is started with a read-only flag, and destructive delete or obliterate actions ask the user to confirm.
Administrators can control access through Perforce server properties set per group or per user. These properties can disable the server globally, restrict toolsets, limit writes, or allow only specific tools. Connection limits on rows returned and scanned protect the server from runaway queries.
It also has an optional integration with P4 DAM, Perforce's asset management product, which adds tools for searching assets, reviewing files and managing workflows when a DAM API key is supplied. The README notes that P4 user accounts must be of the standard type, since service users cannot run several of the commands the tools depend on.
Tools this server provides (17)
Taken from the project documentation; the running server may differ.
- query_server
- Get server information and current user details.
- query_workspaces
- Workspace information and management.
- query_changelists
- Access changelist information and history.
- query_files
- File operations and information.
- query_shelves
- Shelved changelist operations and inspection.
- query_jobs
- Job tracking and defect management.
- query_reviews
- Review discovery, details, and activity.
- query_streams
- Stream hierarchy, integration status, and workspace validation.
- query_p4dam_assets
- Search P4 DAM assets by keyword or filters.
- query_p4dam_asset
- Fetch full metadata for a single P4 DAM asset.
- query_p4dam_projects
- List P4 DAM projects.
- query_p4dam_repositories
- List repositories in a P4 DAM project.
- fetch_p4dam_media
- Fetch and render a P4 DAM media URL as an image.
- query_p4dam_file_reviews
- List file (asset) reviews for a project.
- query_p4dam_file_review
- Fetch a single file review by UUID.
- query_p4dam_workflows
- List P4 DAM workflows.
- modify_workspaces
- Workspace creation and management.
What it does
- Read and write P4 tools
- Query and modify tools cover files, changelists, shelves, workspaces, jobs, streams and reviews.
- Read-only by default safeguards
- Operations run in read-only mode unless writes are enabled, and destructive actions require explicit confirmation.
- Code review support
- Tools can list reviews, read comments and activity, check transitions and manage participants in P4 Code Review.
- Granular access control
- Server properties can enable or disable toolsets and writes per group or user.
- Optional P4 DAM integration
- With a DAM API key, tools search assets, read metadata and manage file reviews and workflows.
- Multiple transports and clients
- Runs over stdio or HTTP and ships as a PyPI package, prebuilt binaries and a Docker image.
Good for
- Asking an AI assistant to summarise a changelist or review its files
- Checking shelved work or workspace status without using the p4 command line
- Searching file history, diffs and blame information during code analysis
- Looking up Perforce jobs linked to a changelist for traceability
- Browsing P4 DAM assets and their metadata from an AI client
Pricing
Open source
Open-source MCP server; the P4 DAM integration requires a separate P4 DAM account.
P4mcp Server FAQ
Does it work with Claude Code and Cursor?
The README includes configuration examples for Claude Code, Cursor, VS Code, Windsurf, Kiro, Eclipse and JetBrains IDEs.
Is it read-only by default?
The README says it runs in read-only mode by default, with write operations enabled when the read-only flag is absent.
Which operating systems are supported?
The README lists Windows 10+, macOS 12+ and Linux with glibc 2.34 or later, and Docker support on macOS and Linux only.
Which Perforce server versions are tested?
The README lists Perforce P4 Server 2026.1 and notes that earlier versions are untested.
Is P4mcp Server free?
Yes. P4mcp Server is open source, so you can use and self-host it for free.
What are the best alternatives to P4mcp Server?
The closest alternatives to P4mcp Server are fastmcp, Git MCP, mcp-pin, VPS MCP & Digital Secretary and MCPProxy.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
