p4mcp-server

Overview

The Perforce P4 MCP Server is a comprehensive implementation that bridges the Model Context Protocol with Perforce Helix Core version control systems. Built on FastMCP with direct P4 Python bindings, it exposes safe, structured tools for managing changelists, files, shelves, workspaces, jobs, reviews, and server metadata. The server is designed with security in mind, featuring a read-only default mode, ownership checks, and interactive confirmation for destructive operations.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• query_changelists

  Read and write changelists in Perforce

  Try:List all my pending changelistsTry:Create a new changelist for bug fixes
• query_files

  Read files and metadata from Perforce

  Try:Show me the content of //depot/main/README.mdTry:List all files in //depot/main/
• query_shelves

  Manage shelves in Perforce

  Try:List all my shelvesTry:Create a new shelf for current changes
• query_workspaces

  Query workspace information from Perforce

  Try:Show me all workspaces for user JohnTry:List files in my main workspace
• query_jobs

  Query and manage jobs in Perforce

  Try:Find all open bugs assigned to meTry:Update job status to resolved
• query_reviews

  Interact with Perforce code reviews

  Try:List all reviews assigned to meTry:Comment on review #12345
• query_streams

  Query Perforce stream information

  Try:List all streams in depotTry:Show details of //depot/main stream
• query_server

  Query server information from Perforce

  Try:Get server version informationTry:Show server configuration

Note: Tool names inferred from the features section that mentions categories of tools (files, changelists, shelves, workspaces, jobs, reviews, streams, and server information). Exact tool names and signatures were not explicitly documented in the

Comparable tools

Installation

{
  "mcpServers": {
    "perforce-p4-mcp": {
      "command": "/absolute/path/to/p4-mcp-server",
      "env": {
        "P4PORT": "ssl:perforce.example.com:1666",
        "P4USER": "your_username",
        "P4CLIENT": "your_workspace"
      },
      "args": [
        "--readonly", "--allow-usage"
      ]
    }
  }
}

FAQ

What Perforce server versions are supported?

The P4 MCP Server supports Perforce P4 Server version 2025.2 (earlier versions are untested).

Can I use the MCP server with Docker?

Yes, the server supports both STDIO and HTTP transport modes in Docker containers with detailed configuration options for different use cases.

Compare p4mcp-server with