P4v Swarm MCP Server

代理IDE-Perforce和Swarm MCP服务器

两台MCP（模型上下文协议）服务器，为您的代理IDE提供完整的Perforce+Swarm超能力：

快速入门（需要零依赖）

git clone 
cd p4v-swarm-mcp-server
chmod +x setup.sh
./setup.sh

就这样 该脚本在裸macOS机器上从头开始安装所有内容：

安装后，重新启动IDE（Cmd+Q，重新打开）并测试：

List my pending changelists

光标AI用户：在Cursor中打开此仓库并询问“设置此仓库”——AI将自动识别并运行设置脚本。

______________________________________________________________________

建筑

脚本直接从这个仓库运行——没有副本，没有占位符，没有部署步骤。

所有配置都以如下方式传递 环境变量 通过 mcp.json.在mcp.json中编辑一次，重新启动IDE，完成。

~/.cursor/mcp.json
    │
    ├── perforce-p4 ──► this-repo/perforce-p4/p4-mcp-start.sh
    │                       ├── reads P4PORT, P4USER, P4_BIN, P4_MCP_SERVER from env
    │                       ├── resolves P4CLIENT from `p4 set`
    │                       ├── auto-login from Keychain if ticket expired
    │                       └── exec p4-mcp-server
    │
    └── p4-workflow ──► this-repo/p4-workflow/server.py
                            ├── reads P4PORT, P4USER, P4_BIN, SWARM_URL from env
                            ├── auto-login from Keychain on every p4 command
                            └── FastMCP server with 10 tools

______________________________________________________________________

手动设置（如果您愿意）

步骤1：安装必备组件

# Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# p4 CLI (pick one)
brew install --cask perforce
# OR download from https://www.perforce.com/downloads/helix-command-line-client-p4

# Python 3, Node.js
brew install python3 node

# Python dependencies
pip3 install fastmcp httpx

# p4-mcp-server — download from https://www.perforce.com/downloads (search "Helix MCP Server")

步骤2：配置mcp.json

复制 mcp.json.template 到 ~/.cursor/mcp.json 并用实际的路径/值替换所有占位符。

步骤3：重新启动IDE并测试

______________________________________________________________________

环境变量

性能-p4（p4-mcp启动.sh）

p4工作流（server.py）

______________________________________________________________________

可用工具

表演-p4（官方）

p4工作流（自定义思科工作流）

______________________________________________________________________

故障排除

MCP服务器未显示在IDE中？

• 检查 ~/.cursor/mcp.json 是有效的JSON（没有尾随逗号）
• 完全重新启动IDE（Cmd+Q，重新打开）

“连接到服务器失败”？

• 检查VPN连接
• 跑 p4 login 在终端刷新您的票

p4工作流“找不到模块”？

• 跑 pip3 install fastmcp httpx
• 如果失败： pip3 install --break-system-packages fastmcp httpx

“必须设置P4PORT”错误？

• 确保 env mcp.json中的块包括 P4PORT 和 P4USER

安装后未找到p4 CLI？

• 检查 ~/bin/p4 存在并且可执行
• 或重新运行 ./setup.sh

______________________________________________________________________

文件结构

p4v-swarm-mcp-server/
  README.md                     <- You are here
  setup.sh                      <- Zero-to-working installer
  mcp.json.template             <- Template for manual ~/.cursor/mcp.json setup
  .gitignore
  .cursor/rules/
    setup-guide.mdc             <- Tells Cursor AI how to set up this repo
  rules/
    p4-workflow.mdc             <- Always-on rule (installed to ~/.cursor/rules/)
  skills/
    p4-workflow/
      SKILL.md                  <- Agent skill (installed to ~/.cursor/skills/)
  perforce-p4/
    p4-mcp-start.sh             <- Wrapper script for official MCP server
  p4-workflow/
    server.py                   <- Custom workflow MCP server
    requirements.txt            <- Python dependencies