mike/open-project-sidecar-mcp
1
1
Fork 0
Code Issues Pull requests Releases 34 Packages 2 Activity Actions
34 releases 35 tags
  • v1.2.0-alpha fd96b4e274

    v1.2.0-alpha — Mode-aware interactive installer
    All checks were successful
    CI / security (push) Successful in 6s
    Details
    CI / lint (push) Successful in 8s
    Details
    CI / test (push) Successful in 14s
    Details
    Pre-release

    Gravity Bot released this 2026-02-15 18:48:30 +00:00 | 179 commits to main since this release

    Highlights

    The first-run installer now asks which deployment mode you want and guides .env creation accordingly. Previously it only supported stdio — now it handles all three modes.

    What's new

    Mode-aware installer (OP#459)

    Running npx open-project-sidecar-mcp with no .env now walks you through:

    1. Deployment mode selection — Local (stdio), Remote (HTTP), or Docker sidecar
    2. Mode-specific credential prompts:
      • stdio: OpenProject URL + API key
      • HTTP server: above + port selection, auto-generated MCP_API_KEY
      • HTTP client: remote server URL + API key (no .env created)
      • Docker: above + container name
    3. Connectivity test — verifies your OpenProject instance is reachable
    4. .env creation — writes credentials to a local file (or appends Docker keys to existing .env)
    5. Client registration — writes config to ~/.claude.json (or preferred MCP client)

    Shared helpers

    Extracted reusable functions used by both promptEnvSetup() (first-run) and runSetupWizard() (--setup):

    • buildEnvContent(mode, credentials) — generates .env content for any mode
    • buildClientConfig(mode, credentials) — generates MCP client config object
    • promptDeploymentMode() / promptCredentials() — interactive prompts
    • testHealth() / testApiDirect() — moved to module scope for shared use

    Updated --help output

    • Removed stale env block from Claude Code example
    • Added --setup and --setup-json to options list
    • Lists all supported environment variables including HTTP transport vars

    README rewrite

    • Quick Start now leads with the installer (npx open-project-sidecar-mcp)
    • Each deployment mode section references the installer
    • New Manual configuration subsection with heredoc examples for CI/scripted use

    Tests

    • 11 new unit tests for buildEnvContent() and buildClientConfig() across all modes
    • 114 tests total, all passing

    Install / upgrade

    npx open-project-sidecar-mcp@1.2.0-alpha

    Full changelog

    • refactor(setup): extract testHealth and testApiDirect to module scope (OP#460)
    • feat(setup): add mode-specific .env templates and buildEnvContent (OP#461)
    • feat(setup): add promptDeploymentMode, promptCredentials, buildClientConfig (OP#462)
    • feat(setup): refactor promptEnvSetup with mode selection and Docker .env merge (OP#463)
    • refactor(setup): simplify runSetupWizard to use shared helpers (OP#464)
    • fix(help): update --help output with installer info and remove env block (OP#465)
    • docs: update README with installer-first Quick Start and manual config section (OP#466)
    • test: add unit tests for buildEnvContent and buildClientConfig (OP#467)
    Downloads