Skip to content

v0.4.0 - 2025-12-31

Choose a tag to compare

@github-actions github-actions released this 31 Dec 22:34
0bc2c73

Release Notes

Added

  • Stdio MCP server support for upstreams via pctx.json (command, args, env).
  • pctx mcp add now supports stdio MCP servers via --command, --arg, and --env flags.
  • pctx mcp start --stdio to serve the MCP interface over stdio.
  • Logger configuration now supports optional file field to write logs to a file.

Changed

  • pctx mcp add now accepts either a URL (for HTTP servers) or --command (for stdio servers), making it a unified interface for adding all types of MCP servers.
  • Logger output behavior is now mode-aware to ensure stdio compatibility:
    • --stdio mode without logger.file: logging is automatically disabled to keep stdout/stderr clean for JSON-RPC communication
    • --stdio mode with logger.file: logs write to the specified file
    • HTTP mode: logs write to stdout (default behavior)

Fixed

  • Improved error handling for stdio config and MCP initialization failures.

Install pctx 0.4.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/portofcontext/pctx/releases/download/v0.4.0/pctx-installer.sh | sh

Install prebuilt binaries via Homebrew

brew install portofcontext/tap/pctx

Install prebuilt binaries into your npm project

npm install @portofcontext/pctx@0.4.0

Download pctx 0.4.0

File Platform Checksum
pctx-aarch64-apple-darwin.tar.gz Apple Silicon macOS checksum
pctx-x86_64-pc-windows-msvc.zip x64 Windows checksum
pctx-aarch64-unknown-linux-gnu.tar.gz ARM64 Linux checksum
pctx-x86_64-unknown-linux-gnu.tar.gz x64 Linux checksum

Verifying GitHub Artifact Attestations

The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:

gh attestation verify <file-path of downloaded artifact> --repo portofcontext/pctx

You can also download the attestation from GitHub and verify against that directly:

gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>