An interactive CLI installer that configures all five cocaxcode MCP servers in your AI tool of choice. It auto-detects your tool, lets you pick which MCPs to add, and writes directly to your user-level global config — merging with your existing setup, never overwriting it.

npx @cocaxcode/suite-mcp install

What's included

| MCP | Tools | Description | |-----|:-----:|-------------| | api-testing | 35 | HTTP testing, collections, assertions, flows, OpenAPI import, mock data, load testing, Postman import/export | | database | 26 | PostgreSQL, MySQL, SQLite management with rollback snapshots, schema search, dump/restore | | devflow | 32 | Jira (Cloud + Server) + GitHub/GitLab integration, custom flows, configurable rules, multi-project | | logbook | 9 | Developer logbook with structured notes, TODOs, code scanning, full-text search | | ai-context-inspector | 5 | Scan, export, and import your AI ecosystem config across 7 tools |

Each MCP is independently published on npm and works standalone. suite-mcp simply wires them all up at once.

Quick start

npx @cocaxcode/suite-mcp install

The CLI detects your AI tool, shows available MCPs, and writes the config. Done.

To install everything without prompts:

npx @cocaxcode/suite-mcp install --all

Usage

Install

# Interactive — pick which MCPs to add
npx @cocaxcode/suite-mcp install

# All MCPs, no prompts
npx @cocaxcode/suite-mcp install --all

# Target a specific AI tool
npx @cocaxcode/suite-mcp install --target cursor
npx @cocaxcode/suite-mcp install --target gemini --all

Note: Already-installed MCPs are skipped automatically. Only missing ones get added.

List status

npx @cocaxcode/suite-mcp list

@cocaxcode/suite-mcp — Available MCPs (claude)

  Status  MCP                   Description
  ✓       api-testing           API testing with collections, assertions, and flows
  ✓       database              PostgreSQL, MySQL, and SQLite management
  ✓       devflow               Jira + GitHub/GitLab workflow automation
  ✗       logbook               Developer logbook with notes and TODOs
  ✗       ai-context-inspector  AI ecosystem scanner and migrator

  3/5 installed

Remove

npx @cocaxcode/suite-mcp remove

Shows only installed MCPs and lets you choose which to remove. Empty selection cancels.

Command reference

| Command | Description | |---------|-------------| | install | Add MCPs to your AI tool config | | remove | Remove installed MCPs | | list | Show installation status |

| Flag | Description | |------|-------------| | --target <tool> | Force AI tool: claude, cursor, windsurf, copilot, gemini, codex, opencode | | --all | Install all MCPs without prompting | | --version | Show version |

Supported AI tools

suite-mcp auto-detects your tool by scanning for marker files in the working directory, then installs MCPs into your user-level global config so they are available in every project.

| Tool | Global config file | Format | |------|-------------------|--------| | Claude Code | ~/.claude/settings.json | nested | | Cursor | ~/.cursor/mcp.json | flat | | Windsurf | ~/.codeium/windsurf/mcp_config.json | nested | | Gemini CLI | ~/.gemini/settings.json | nested | | GitHub Copilot | .vscode/mcp.json (project-local) | flat | | Codex CLI | .mcp.json (project-local) | flat | | OpenCode | opencode.json (project-local) | nested |

Tip: If no tool is detected, the CLI prompts you to choose one. Use --target to skip detection entirely.

What it does NOT do

• Does not run MCP servers. It only writes config files. Each MCP runs via npx at invocation time.
• Does not manage versions. MCPs install with @latest. Re-run install to pick up updates.
• Does not bundle MCPs together. Each server stays independent with its own lifecycle and data.
• Does not touch non-cocaxcode entries. Your existing MCP configs are preserved — merge, never overwrite.

Architecture

src/
├── index.ts       # CLI entry point and arg parsing
├── types.ts       # TypeScript interfaces
├── registry.ts    # MCP catalog (add new MCPs here)
├── config.ts      # Config read/write with atomic operations
├── detect.ts      # AI tool auto-detection via marker files
├── prompts.ts     # Interactive readline prompts
├── install.ts     # Install subcommand
├── remove.ts      # Remove subcommand
├── list.ts        # List subcommand
└── __tests__/     # 52 tests across 5 suites

• Zero runtime dependencies — uses only Node.js built-ins (readline, fs, crypto, path, os)
• Atomic writes — write to temp file, then rename, preventing config corruption on crash
• Path traversal protection — all file paths are validated to stay within the user's home directory or working directory
• Merge, never overwrite — existing MCP entries from other sources are always preserved
• 52 tests — config I/O, detection logic, parsing, and security edge cases

Stack: TypeScript · ESM · tsup · Vitest · Node >= 20

MIT · Built by cocaxcode