Skip to content
MCP server

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.

How AIPoweredBot checks servers