@cocaxcode/suite-mcp

All cocaxcode MCP servers. One command.
4 MCPs · 70+ tools · Zero config · Any AI tool.

What is this · What's included · Installation · Usage · Supported AI tools · Architecture · Contributing

What is this?

Installing MCP servers one by one is tedious. Each tool has its own npm package, its own config format, and some need special flags. You end up copy-pasting JSON configs or running 4+ separate commands.

suite-mcp fixes that. One command installs all cocaxcode MCP servers in your AI tool. It detects your tool, asks which MCPs you want, and writes the correct config.

npx @cocaxcode/suite-mcp install

That's it. All 4 MCPs configured and ready.

What's included

suite-mcp bundles 4 production-ready MCP servers with 70+ tools total:

| MCP | Tools | What it does | |-----|:-----:|-------------| | api-testing | 35 | HTTP testing, assertions, flows, OpenAPI import, mock data, load testing, Postman import/export | | database | 26 | PostgreSQL, MySQL, SQLite management with rollback snapshots, schema introspection, dump/restore | | logbook | 9 | Developer logbook with notes, TODOs, code TODO scanning, full-text search | | ai-context-inspector | 5 | Scan, export, and import your AI ecosystem across 7 tools |

Each MCP is independently published on npm and can be installed separately. suite-mcp just makes installing all of them effortless.

Installation

Quick start (recommended)

npx @cocaxcode/suite-mcp install

The CLI will:

Detect your AI tool (Claude, Cursor, Windsurf, etc.)
Show which MCPs are available
Ask which ones to install
Write the correct config

Install all without prompts

npx @cocaxcode/suite-mcp install --all

Force a specific AI tool

npx @cocaxcode/suite-mcp install --target cursor
npx @cocaxcode/suite-mcp install --target gemini --all

Usage

Install MCPs

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

# Install all at once
npx @cocaxcode/suite-mcp install --all

# Force target tool
npx @cocaxcode/suite-mcp install --target cursor --all

If an MCP is already installed, it gets skipped automatically. Only missing MCPs are added.

Check status

npx @cocaxcode/suite-mcp list

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

  Estado  MCP                   Descripcion
  ✓       api-testing           Testing de APIs con collections, assertions y flows
  ✓       database              Gestion de PostgreSQL, MySQL y SQLite
  ✗       logbook               Logbook de desarrollo con notas y TODOs
  ✗       ai-context-inspector  Scanner y migrador de ecosistema AI

  2/4 instalados

Remove MCPs

npx @cocaxcode/suite-mcp remove

Shows only installed MCPs and asks which to remove. Enter without selection cancels.

All commands

| Command | Description | |---------|-------------| | install | Install MCPs in 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 AI tool by scanning for marker files in the current directory. All 7 major tools are supported:

| Tool | Config file | Format | |------|------------|--------| | Claude Code | .mcp.json | flat | | Cursor | .cursor/mcp.json | flat | | Windsurf | .mcp.json | flat | | GitHub Copilot | .vscode/mcp.json | flat | | Gemini CLI | .gemini/settings.json | nested | | Codex CLI | .mcp.json | flat | | OpenCode | opencode.json | nested |

If no tool is detected, the CLI asks which one to configure. Use --target to skip detection.

What it does NOT do

It doesn't run MCP servers. It only writes config files. Each MCP runs independently via npx.
It doesn't manage versions. All MCPs install with @latest. To update, just re-run install.
It doesn't bundle MCPs. Each MCP stays independent with its own lifecycle and storage.
It doesn't touch non-cocaxcode MCPs. Your existing MCP configs are preserved (merge, never overwrite).

Architecture

Built for safety and simplicity:

Zero runtime dependencies — only Node.js built-ins (readline, fs, crypto)
Atomic writes — write-to-temp-then-rename prevents config corruption
Path traversal protection — validates all file paths stay inside the working directory
JSON type validation — handles malformed config files gracefully
Merge, never overwrite — preserves existing MCP configs from other sources
52 tests — covering config I/O, detection, parsing, and security edge cases

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

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

Contributing

git clone https://github.com/cocaxcode/suite-mcp.git
cd suite-mcp
npm install
npm test            # 52 tests
npm run build       # ESM bundle
npm run typecheck   # TypeScript check

How to contribute

Bug reports — open an issue with steps to reproduce
Feature requests — describe your use case
Pull requests — fork, add tests, ensure all tests pass

License

MIT — built by cocaxcode

MCP Servers