MCP Perforce Server
@Cocoon-AI
About 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"
}
}
}
}Tools
25Add 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
.p4configfiles. - 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.
Frequently asked questions
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`.
Basic information
More Other MCP servers
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
IDA Pro MCP
mrexodiaAI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.
XcodeBuildMCP
cameroncookeA Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Figs, Relationship Expert
Figs O'Sullivan, LMFTCouples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep
MaxKB
1Panel-dev🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。
Comments