MCP Perforce Server

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.

FAQ from MCP Perforce Server

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.

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.

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.

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.

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.