MCP.so
登录

MCP Perforce Server

@Cocoon-AI

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

Cocoon-AI

关于 MCP Perforce Server

MCP Perforce Server

MCP Perforce Server 配置

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

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

MCP Perforce Server 工具

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

概览

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.

常见问题

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`.

评论

其他 分类下的更多 MCP 服务器