P4 MCP Server 2026.1 - Stream Tools

P4 MCP Server 2026.1 adds full stream operations support—including switching, creating, merging, and propagation between streams—along with admin and user controls for enabling or disabling tools via p4 property at global, group, and user levels. The release introduces remote HTTP deployment for shared MCP access, a pre-built Linux binary, SSL/CA certificate support, MCP Registry discovery, and confirmation prompts for all destructive operations. Infrastructure improvements include FastMCP 3 with Search Transforms, non-root Docker execution, and a modular codebase refactor. Security fixes address two CVEs, and several bug fixes resolve issues with shared workspaces, safety gate enforcement, and unintended user creation.

Author: hjain-perforce

Dockerfile

@@ -7,7 +7,6 @@ RUN apt-get update && apt-get install -y \
     build-essential \
     && rm -rf /var/lib/apt/lists/*
 
-RUN useradd -m mcpuser
 # Set working directory
 WORKDIR /app
 
@@ -18,10 +17,18 @@ RUN pip install --no-cache-dir -r requirements.txt
 # Copy application code
 COPY src/ ./src/
 
+# Create non-root user and setup permissions
+RUN useradd -u 1000 -m -s /bin/bash mcpuser && \
+    mkdir -p /app/logs && \
+    chown -R mcpuser:mcpuser /app/logs
+    
 # Set environment variables
 ENV PYTHONPATH=/app
 ENV P4TICKETS=/home/mcpuser/.p4tickets
+ 
+# Switch to non-root user
+USER mcpuser
 
-# Run the server
+# Run the serve
 ENTRYPOINT ["python3", "-m", "src.main"]
-CMD ["--transport", "stdio"]
+CMD ["--transport", "stdio"]

README.md

@@ -3,14 +3,10 @@ import os
 import sys
 import importlib.metadata
 from PyInstaller.utils.hooks import collect_data_files, collect_submodules
-import fakeredis
-fakeredis_path = os.path.dirname(fakeredis.__file__)
 
 dist = importlib.metadata.distribution("fastmcp")
 fastmcp_dist_info = dist._path
 
-# Collect fakeredis data files (commands.json)
-fakeredis_data = collect_data_files('fakeredis')
 
 # Collect rich._unicode_data submodules (dynamically imported at runtime)
 rich_unicode_imports = collect_submodules('rich._unicode_data')
@@ -29,10 +25,8 @@ a = Analysis(
         ('icons/logo-p4mcp-icon.png', 'icons'),
         ('icons/logo-p4mcp-reg.png', 'icons'),
         (fastmcp_dist_info, os.path.basename(fastmcp_dist_info)),
-        (os.path.join(fakeredis_path, 'commands.json'), 'fakeredis'),
-        (os.path.join(fakeredis_path, 'model'), 'fakeredis/model'),
-    ] + fakeredis_data,
-    hiddenimports=['lupa', 'lupa.lua51'] + rich_unicode_imports,
+    ],
+    hiddenimports=rich_unicode_imports,
     hookspath=[],
     hooksconfig={},
     runtime_hooks=[],

THIRD-PARTY-NOTICES.txt

@@ -1,77 +1,72 @@
-altgraph==0.17.5
+aiofile==3.9.0
 annotated-types==0.7.0
-anyio==4.12.1
-attrs==25.4.0
-Authlib==1.6.6
+anyio==4.13.0
+attrs==26.1.0
+Authlib==1.6.11
 beartype==0.22.9
-certifi==2026.1.4
+cachetools==7.0.5
+caio==0.9.25
+certifi==2026.2.25
 cffi==2.0.0
-charset-normalizer==3.4.4
-click==8.3.1
-cloudpickle==3.1.2
-cryptography==46.0.5
-cyclopts==4.5.1
-docstring_parser==0.17.0
+charset-normalizer==3.4.7
+click==8.3.2
+cryptography==46.0.7
+cyclopts==4.10.2
+dnspython==2.8.0
+docstring_parser==0.18.0
 docutils==0.22.4
+email-validator==2.3.0
 exceptiongroup==1.3.1
-fakeredis==2.33.0
-fastmcp==2.14.4
+fastmcp==3.2.4
+griffelib==2.0.2
 h11==0.16.0
 httpcore==1.0.9
 httpx==0.28.1
 httpx-sse==0.4.3
 idna==3.11
 importlib_metadata==8.7.1
+jaraco.classes==3.4.0
+jaraco.context==6.1.2
+jaraco.functools==4.4.0
 jsonref==1.1.0
 jsonschema==4.26.0
-jsonschema-path==0.3.4
+jsonschema-path==0.4.5
 jsonschema-specifications==2025.9.1
-lupa==2.6
-macholib==1.16.4
+keyring==25.7.0
 markdown-it-py==4.0.0
-mcp==1.26.0
+mcp==1.27.0
 mdurl==0.1.2
+more-itertools==11.0.2
 openapi-pydantic==0.5.1
-opentelemetry-api==1.39.1
-opentelemetry-exporter-prometheus==0.60b1
-opentelemetry-instrumentation==0.60b1
-opentelemetry-sdk==1.39.1
-opentelemetry-semantic-conventions==0.60b1
+opentelemetry-api==1.41.0
 p4python==2025.2.2863679
-packaging==26.0
-pathable==0.4.4
-platformdirs==4.5.1
-prometheus_client==0.24.1
-py-key-value-aio==0.3.0
-py-key-value-shared==0.3.0
+packaging==26.1
+pathable==0.5.0
+platformdirs==4.9.6
+py-key-value-aio==0.4.4
 pycparser==3.0
-pydantic==2.12.5
-pydantic-settings==2.12.0
-pydantic_core==2.41.5
-pydocket==0.16.6
-Pygments==2.19.2
-PyJWT==2.11.0
+pydantic==2.13.2
+pydantic-settings==2.13.1
+pydantic_core==2.46.2
+Pygments==2.20.0
+PyJWT==2.12.1
 pyperclip==1.11.0
-python-dotenv==1.2.1
-python-json-logger==4.0.0
-python-multipart==0.0.22
+python-dotenv==1.2.2
+python-multipart==0.0.26
 PyYAML==6.0.3
-redis==7.1.0
-referencing==0.36.2
-requests==2.32.5
-rich==14.3.2
+referencing==0.37.0
+requests==2.33.1
+rich==15.0.0
 rich-rst==1.3.2
 rpds-py==0.30.0
-setuptools==80.10.2
-shellingham==1.5.4
-sortedcontainers==2.4.0
-sse-starlette==3.2.0
-starlette==0.52.1
-typer==0.21.1
+sse-starlette==3.3.4
+starlette==1.0.0
+truststore==0.10.4
 typing-inspection==0.4.2
 typing_extensions==4.15.0
+uncalled-for==0.3.1
 urllib3==2.6.3
-uvicorn==0.40.0
+uvicorn==0.44.0
+watchfiles==1.1.1
 websockets==16.0
-wrapt==1.17.3
-zipp==3.23.0
+zipp==3.23.1

p4-mcp-server.spec

@@ -0,0 +1,77 @@
+---
+name: p4-changelist-management
+description: P4 changelist workflows — create, list, submit, shelve, unshelve, and manage changelists and shelved files via P4 MCP tools. Use when: creating changelists, editing files, shelving, unshelving, submitting, organizing changes, or managing pending work in P4.
+---
+
+# Changelist Management
+
+Use the `query_changelists`, `modify_changelists`, `query_shelves`, and `modify_shelves` tools to manage P4 changelists and shelved files.
+
+## Querying Changelists
+
+| Action | Purpose | Key Parameters |
+|--------|---------|----------------|
+| `list` | List changelists with filters | `status`, `user`, `workspace_name`, `depot_path`, `max_results` |
+| `get` | Get full changelist details | `changelist_id` |
+
+## Modifying Changelists
+
+| Action | Purpose | Key Parameters |
+|--------|---------|----------------|
+| `create` | Create a new pending changelist | `description` |
+| `update` | Update changelist description or fields | `changelist_id`, `description` |
+| `submit` | Submit a pending changelist | `changelist_id` |
+| `delete` | Delete an empty pending changelist (requires approval) | `changelist_id` |
+| `move_files` | Move files to a target changelist | `changelist_id`, `file_paths` |
+
+## Querying Shelves
+
+| Action | Purpose | Key Parameters |
+|--------|---------|----------------|
+| `list` | List shelved changelists | `user`, `max_results` |
+| `diff` | View diff of shelved files | `changelist_id` |
+| `files` | List files in a shelved changelist | `changelist_id` |
+
+## Modifying Shelves
+
+| Action | Purpose | Key Parameters |
+|--------|---------|----------------|
+| `shelve` | Shelve files from a pending changelist | `changelist_id`, `file_paths` |
+| `unshelve` | Unshelve files back to the same changelist | `changelist_id`, `file_paths` |
+| `unshelve_to_changelist` | Unshelve files into a different changelist | `changelist_id`, `target_changelist`, `file_paths` |
+| `update` | Update shelved files with new edits | `changelist_id`, `file_paths` |
+| `delete` | Delete shelved files (requires approval) | `changelist_id`, `file_paths`, `force` |
+
+## Common Workflows
+
+### Make and submit a change
+
+1. `modify_changelists` → `create` a pending changelist
+2. `modify_files` → `edit` (or `add`/`delete`) to open files for edit in the changelist
+3. `modify_changelists` → `submit` to commit the change
+
+### Shelve work in progress
+
+1. `modify_changelists` → `create` a pending changelist
+2. `modify_files` → `edit` to open files
+3. `modify_shelves` → `shelve` to store changes server-side
+4. `modify_files` → `revert` local copies (shelve is preserved)
+
+### Resume shelved work
+
+1. `query_shelves` → `list` to find your shelved changelists
+2. `modify_shelves` → `unshelve` to restore files to your workspace
+3. Continue editing, then `modify_changelists` → `submit`
+
+### Organize files across changelists
+
+1. `query_changelists` → `list` with `status=pending` to see your open changelists
+2. `modify_changelists` → `move_files` to reorganize files between changelists
+
+## Best Practices
+
+- Always provide a meaningful description when creating changelists.
+- Shelve before sharing work with others (e.g., for code review).
+- Use `query_shelves` → `diff` to verify shelved content before unshelving.
+- Submit changelists promptly to avoid long-lived pending changes.
+- Use `move_files` to keep changelists focused on a single logical change.

requirements.txt

@@ -0,0 +1,102 @@
+---
+name: p4-code-review
+description: P4 code review workflows — discover, create, vote, comment, transition, and manage reviews via P4 MCP tools. Use when: creating reviews, voting, commenting, transitioning review states, managing participants, or tracking review activity in P4.
+---
+
+# Code Review Workflows
+
+Use the `query_reviews` and `modify_reviews` tools to manage P4 Code Review code reviews.
+
+## Querying Reviews
+
+| Action | Purpose | Key Parameters |
+|--------|---------|----------------|
+| `list` | List reviews with filters | `review_fields`, `max_results` |
+| `dashboard` | Get review dashboard for current user | — |
+| `get` | Get full review details | `review_id` |
+| `transitions` | Get available state transitions | `review_id` |
+| `files` | List files in a review | `review_id` |
+| `files_readby` | Check which files have been read by reviewers | `review_id` |
+| `comments` | Get all comments on a review | `review_id` |
+| `activity` | Get review activity log | `review_id` |
+
+## Modifying Reviews
+
+### Lifecycle
+
+| Action | Purpose | Key Parameters |
+|--------|---------|----------------|
+| `create` | Create a new review from a changelist | `change_id`, `description` |
+| `transition` | Move review to a new state | `review_id`, `transition` |
+| `archive_inactive` | Archive stale reviews | `not_updated_since`, `max_reviews` |
+| `obliterate` | Permanently remove a review (requires approval) | `review_id` |
+
+### Voting & Participation
+
+| Action | Purpose | Key Parameters |
+|--------|---------|----------------|
+| `vote` | Vote on a review (up/down/clear) | `review_id`, `vote_value` |
+| `append_participants` | Add reviewers | `review_id`, `users`, `groups` |
+| `replace_participants` | Replace all reviewers | `review_id`, `users`, `groups` |
+| `delete_participants` | Remove reviewers | `review_id`, `users`, `groups` |
+| `join` | Join a review as participant | `review_id` |
+| `leave` | Leave a review | `review_id` |
+
+### Comments
+
+| Action | Purpose | Key Parameters |
+|--------|---------|----------------|
+| `add_comment` | Add a new comment | `review_id`, `body`, `context` |
+| `reply_comment` | Reply to an existing comment | `review_id`, `comment_id`, `body` |
+| `mark_comment_read` | Mark a comment as read | `review_id`, `comment_id` |
+| `mark_comment_unread` | Mark a comment as unread | `review_id`, `comment_id` |
+| `mark_all_comments_read` | Mark all comments as read | `review_id` |
+| `mark_all_comments_unread` | Mark all comments as unread | `review_id` |
+
+### Changelist Management
+
+| Action | Purpose | Key Parameters |
+|--------|---------|----------------|
+| `append_change` | Add a changelist to a review | `review_id`, `change_id` |
+| `replace_with_change` | Replace review content with a new changelist | `review_id`, `change_id` |
+
+### Metadata
+
+| Action | Purpose | Key Parameters |
+|--------|---------|----------------|
+| `update_author` | Change the review author | `review_id`, `new_author` |
+| `update_description` | Update review description | `review_id`, `new_description` |
+| `refresh_projects` | Refresh project associations | `review_id` |
+
+## Common Workflows
+
+### Submit code for review
+
+1. `modify_changelists` → `create` a pending changelist with your edits
+2. `modify_shelves` → `shelve` the changelist
+3. `modify_reviews` → `create` a review from the changelist
+4. `modify_reviews` → `append_participants` to add reviewers
+
+### Review code
+
+1. `query_reviews` → `dashboard` to see reviews assigned to you
+2. `query_reviews` → `get` to see review details
+3. `query_reviews` → `files` to see changed files
+4. `query_reviews` → `comments` to see existing discussion
+5. `modify_reviews` → `add_comment` to provide feedback
+6. `modify_reviews` → `vote` to approve or request changes
+7. `query_reviews` → `transitions` to see available state changes
+8. `modify_reviews` → `transition` to approve/reject
+
+### Update a review
+
+1. Make edits and shelve the updated changelist
+2. `modify_reviews` → `replace_with_change` to update review content
+3. Review comments and address feedback
+
+## Best Practices
+
+- Check `transitions` before calling `transition` to verify the target state is valid.
+- Use `files_readby` to track which reviewers have seen the latest changes.
+- Always `shelve` changes before creating a review so reviewers can see the diff.
+- Use `append_participants` rather than `replace_participants` to avoid removing existing reviewers.