Advertise
MCP.so
Sign In

MCP Perforce Server

@Cocoon-AI

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

Cocoon-AI

About MCP Perforce Server

MCP Perforce Server

MCP Perforce Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "perforce": {
      "command": "npx",
      "args": [
        "-y",
        "@cocoon-ai/mcp-perforce"
      ],
      "env": {
        "P4CONFIG": ".p4config"
      }
    }
  }
}

MCP Perforce Server tools

25

Add files to Perforce

Open files for edit in Perforce

Mark files for deletion in Perforce

Revert files or changelist

Sync files from the depot

Show differences for files

Create a new changelist with a description

Submit a changelist

Move files to a specific changelist

Get current P4 workspace status and pending changes

Show Perforce configuration info for current directory

Show MCP Perforce server version

FOR DEBUGGING: Executes a raw p4 command and returns stdout/stderr

List all streams or streams matching a pattern

Get detailed information about a specific stream

Switch workspace to a different stream

Create a new stream

Edit stream specification

Show stream hierarchy graph

List all clients/workspaces for the current user

Get detailed information about a specific client/workspace

Create a new client/workspace

Edit an existing client/workspace specification

Delete a client/workspace

Switch to a different client/workspace

Overview

What is MCP Perforce Server?

A Model Context Protocol (MCP) server that provides a clean, non-interactive interface for Perforce (P4) operations in Claude Desktop. It wraps P4 commands to eliminate interactive prompts and complex state management, making them more reliable for AI assistants.

How to use MCP Perforce Server?

Install the package globally via npm and add it to Claude Desktop configuration. The server uses .p4config files for automatic per-project Perforce settings. Once configured, you ask Claude to execute commands like p4_status, p4_sync, p4_changelist_create, or p4_stream_switch.

Key features of MCP Perforce Server

  • Non-interactive operations that avoid interactive prompts.
  • Structured, parseable responses instead of raw P4 output.
  • Multi-project support via .p4config files.
  • File operations: add, edit, delete, revert, sync, diff.
  • Changelist management: create and submit changelists.
  • Stream operations: list, info, switch, create, edit, graph.

Use cases of MCP Perforce Server

  • Letting Claude create changelists and submit changes automatically.
  • Syncing workspace and reviewing open files in a single conversation.
  • Switching between Perforce servers based on project directory.
  • Managing streams and clients without typing raw P4 commands.

Frequently asked questions

1

What are the prerequisites for MCP Perforce Server?

Node.js 18+ and the Perforce command-line client (p4) must be installed and in your PATH. `.p4config` files in project directories are recommended.

2

How does MCP Perforce Server handle multiple Perforce servers?

It uses Perforce's built-in P4CONFIG mechanism. The server reads `.p4config` files from the current or parent directories to automatically switch between servers based on your working directory.

3

What should I do if the server doesn't appear in Claude?

Restart Claude Desktop, verify the configuration file is valid JSON, and confirm the package is installed globally with `npm list -g @cocoon-ai/mcp-perforce`.

4

How can I debug issues with MCP Perforce Server?

Enable debug logging by adding `"DEBUG": "mcp:*"` to the environment variables in the server configuration. You can also test P4 connectivity with `p4 info` and `p4 login` in your terminal.

5

What transports or authentication does MCP Perforce Server support?

The server uses the standard MCP SDK and relies on Perforce's own authentication (e.g., `p4 login`). It reads credentials and settings from `.p4config` files or environment variables like `P4PORT`, `P4CLIENT`, and `P4USER`.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Advertise