v0.3.0 — Security doctrine, esbuild bundling, installer fixes

What's new

Security Doctrine

• Credentials never leak to Claude servers. The SKILL.md now includes explicit rules: credentials stay in .env files, never passed as tool arguments, never logged, never sent to remote APIs through Claude. The generated .env.example documents what's needed without exposing real values.

Node.js esbuild bundling

• All Node.js templates now include esbuild for production bundling. npm run build creates a single dist/mcp-server.js file. npm run dev runs from source for development.

New project type: data-connector

• Connect to databases or data warehouses and expose query capabilities as MCP tools.

Installer improvements

• Fixed stdin handling when piped from curl | bash (re-exec with /dev/tty)
• Correct Claude Desktop config paths for all platforms (macOS, Linux, Windows)
• Correct Claude Code config paths (~/.claude/settings.json and ~/.claude.json)
• Reverted aggressive reinstall behavior — existing installs update cleanly

Skill improvements

• Common pitfalls guide with credential safety rules
• Better Claude Desktop / Claude Code configuration instructions
• uv availability check before running CLI

Install

Claude Code plugin:

Install this plugin: https://github.com/Percona-Lab/CAIRN

CLI:

curl -fsSL -o /tmp/cairn.whl https://github.com/Percona-Lab/CAIRN/releases/latest/download/cairn_mcp-0.3.0-py3-none-any.whl
uvx --from /tmp/cairn.whl cairn init

v0.2.0 — CAIRN: Create Any Integration, Run Naturally

Renamed from easyMCP to CAIRN. Now scaffolds any kind of MCP server, not just doc-search.

Three project types

Type	What it builds
API integration	Connector class + MCP server wrapping an external REST API
Doc search	Semantic search over GitHub repos with Markdown (the percona-dk pattern)
Starter	Minimal MCP server with one example tool

Install

curl -fsSL -o /tmp/cairn.whl https://github.com/Percona-Lab/CAIRN/releases/latest/download/cairn_mcp-0.2.0-py3-none-any.whl
uvx --from /tmp/cairn.whl cairn init

Requires uv. Install with: curl -LsSf https://astral.sh/uv/install.sh | sh

What changed from v0.1.0

• Renamed: easyMCP → CAIRN (part of the Alpine Toolkit)
• New: api-integration project type (connector + MCP server, like IBEX)
• New: starter project type (minimal MCP server skeleton)
• Templates restructured: templates/{type}/{language}/
• Prompts now ask project type first, then branch
• Python + Node.js templates for all three types

v0.1.0 — Initial Release

First release of easyMCP — scaffold production-ready MCP servers with polished cross-platform installers.

What is easyMCP?

easyMCP generates complete, standalone MCP server projects for any domain — not just documentation. You define your data sources (GitHub repos with Markdown), and easyMCP scaffolds a full project with a polished cross-platform installer that guides your users through setup with interactive prompts, progress bars, and auto-configuration of AI clients.

The generated installer gives your users a professional, one-command install experience on macOS, Linux, and Windows — the same quality as percona-dk.

Install

As a Claude Code plugin (recommended):

Install this plugin: https://github.com/Percona-Lab/easymcp

Then ask Claude: "Create a new MCP server for my docs"

Or download the plugin zip from the assets below and extract to ~/.claude/plugins/easymcp/

Or run the CLI directly:

curl -fsSL -o /tmp/easymcp.whl https://github.com/Percona-Lab/easymcp/releases/latest/download/easymcp-0.1.0-py3-none-any.whl
uvx --from /tmp/easymcp.whl easymcp init

What's included

• Python template: FastMCP + ChromaDB + FastAPI with incremental ingestion
• Node.js template: @modelcontextprotocol/sdk + ChromaDB + Express
• Cross-platform installer: ANSI colors, interactive stack selection, parallel GitHub API fetching, time/disk estimates, progress bars, AI client auto-detection (Claude Desktop + Claude Code), incremental re-ingestion
• Bootstrap scripts: curl | bash (macOS/Linux) and irm | iex (Windows) one-liners for your end users