MCP Perforce Server

Name: MCP Perforce Server
Author: Cocoon-AI

@Cocoon-AI

代码仓库

关于 MCP Perforce Server

MCP Perforce Server

基本信息

分类

其他

许可证

MIT

运行时

node

传输方式

stdio

发布者

Cocoon-AI

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.