v0.2.2

v0.2.2 is a focused quality-of-life release that makes mcpr play nicer with real-world dev environments. If you use custom config directories, non-standard XDG paths, or want to manage MCP servers per-project in OpenAI Codex — this one's for you.

🐛 Bug Fixes

Claude Code: CLAUDE_CONFIG_DIR is now respected

If you've set CLAUDE_CONFIG_DIR to point to a custom location, mcpr now picks it up automatically instead of always falling back to ~/.claude.json. No more manual path wrangling.

# Works as expected even with a custom Claude config dir
export CLAUDE_CONFIG_DIR=/custom/path/to/claude
mcpr client sync claude-code
# → writes to /custom/path/to/claude/claude.json ✓

VS Code (Linux): XDG_CONFIG_HOME is now respected

On Linux, mcpr now honours the XDG_CONFIG_HOME environment variable when locating VS Code's settings.json, in line with the XDG Base Directory Specification. If XDG_CONFIG_HOME is unset, it falls back to ~/.config as before.

export XDG_CONFIG_HOME=/opt/config
mcpr client sync vscode
# → writes to /opt/config/Code/User/settings.json ✓

✨ New Features

Codex: local project scope support

OpenAI Codex CLI now supports --local syncing! mcpr will write per-project MCP configuration to .codex/config.toml in your current directory. Because Codex enforces project trust levels, mcpr validates that the project is trusted before writing and gives you a clear, actionable error if it isn't.

# Sync MCP servers to your current project's Codex config
mcpr client sync codex --local

# If the project isn't trusted yet, you'll see exactly what to add:
# project "/home/you/my-app" is not trusted in Codex
#
# To enable local configuration, add the following to ~/.codex/config.toml:
#
# [projects."/home/you/my-app"]
# trust_level = "trusted"

---

Installation

go install github.com/mathematic-inc/mcpr@v0.2.2

mcpr is free and open-source work by a 501(c)(3) non-profit. If you find it useful, please consider sponsoring the project. 💙

v0.2.1

v0.2.1 is a polish release that keeps the mcpr machinery running smoothly. Hot on the heels of the v0.2.0 migration to the mathematic-inc organization, this patch tightens up the automated release pipeline so that publishing new versions is reliable regardless of the environment — meaning you can expect consistently great release notes for every future release of mcpr, the unified MCP server manager for Claude Desktop, Cursor, VS Code, Windsurf, Zed, OpenCode, Gemini CLI, and more.

🐛 Bug Fixes

• Resilient release-notes workflow — The GitHub Actions workflow that generates and publishes release notes now uses continue-on-error so that a missing Claude Code App installation no longer blocks the entire release process. The pipeline keeps moving and the release gets out the door. (#5)

---

Not yet using mcpr? It's the one command that syncs your MCP servers everywhere:

# Add a server once…
mcpr add stdio --name filesystem npx -y @modelcontextprotocol/server-filesystem ~/projects

# …and push it to every tool you use
mcpr client sync claude-desktop
mcpr client sync cursor
mcpr client sync vscode

Installation

go install github.com/mathematic-inc/mcpr@v0.2.1

v0.2.0

0.2.0 (2026-03-11)

⚠ BREAKING CHANGES

• migrate module to mathematic-inc organization (#3)

Features

• Migrate module to mathematic-inc organization (#3) (9f9cb0a)

What's Changed

• feat!: migrate module to mathematic-inc organization by @jrandolf in #3
• chore(main): release 0.2.0 by @jrandolf in #4

New Contributors

• @jrandolf made their first contribution in #3

Full Changelog: https://github.com/mathematic-inc/mcpr/commits/v0.2.0