Rename to CAIRN, add api-integration and starter project types

CAIRN — Create Any Integration, Run Naturally. Renamed from easyMCP
to reflect that this tool scaffolds ANY kind of MCP server, not just
doc-search servers.

Three project types:
- api-integration: connector class + MCP server wrapping external APIs
  (like IBEX's Slack/Jira/Notion pattern). Prompts for service name,
  base URL, auth method, and tool definitions.
- doc-search: the original percona-dk pattern (unchanged, just moved
  into templates/doc-search/)
- starter: minimal MCP server with one example tool

Other changes:
- Restructured templates/ into templates/{type}/{language}/
- scaffold.py resolves: common/ + {type}/common/ + {type}/{language}/
- prompts.py asks project type first, then branches
- Package renamed: easymcp -> cairn-mcp, CLI: cairn init
- Python + Node.js templates for all three types

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: thefactremains

README.md

@@ -1,104 +1,81 @@
-# easyMCP
+# CAIRN
 
-Scaffold production-ready MCP servers for **any domain** — with polished cross-platform installers that guide your users through setup.
+**Create Any Integration, Run Naturally.** Scaffold production-ready MCP servers for any domain.
 
-You define your data sources. easyMCP generates a complete, standalone project that includes everything your users need to install and run it: interactive prompts, progress bars, time estimates, and auto-configuration of AI clients. One command to scaffold. One command for your users to install.
+Named for the stacked stone trail markers that guide climbers on mountain paths. Part of the [Alpine Toolkit](https://github.com/Percona-Lab).
 
-## What easyMCP does
+## What it does
 
-easyMCP is a project generator. You answer a few questions — project name, language, data sources — and it outputs a complete MCP server project with:
+CAIRN generates complete, standalone MCP server projects. You pick a project type, answer a few prompts, and get a working project ready to push to GitHub.
 
-**For you (the builder):**
-- A working MCP server, REST API, and ingestion pipeline — ready to customize
-- Python (FastMCP + ChromaDB + FastAPI) or Node.js (@modelcontextprotocol/sdk + ChromaDB + Express)
-- All the boilerplate: `pyproject.toml` / `package.json`, `.env`, `.gitignore`, `LICENSE`, `README`
+**Three project types:**
 
-**For your users (the installers):**
-- `curl | bash` / `irm | iex` one-liner install scripts
-- A cross-platform interactive installer (`installer.py`) with:
-  - ANSI colors with Windows support
-  - Interactive stack selection — "Install all / Skip / Choose individually"
-  - Live time and disk estimates per repo (fetched from GitHub API in parallel)
-  - Review loop before committing
-  - Progress bars during embedding
-  - Auto-detection and configuration of Claude Desktop and Claude Code
-  - Incremental re-ingestion (only re-embeds files that changed)
-  - Smart rerun detection (existing install becomes update flow)
-
-The generated project is **standalone** — no runtime dependency on easyMCP. Push it to GitHub and your users install with a one-liner.
+| Type | What it builds | Example |
+|------|---------------|---------|
+| **API integration** | Wrap an external REST API as MCP tools | Slack, Jira, Stripe connectors |
+| **Doc search** | Semantic search over GitHub repos with Markdown | percona-dk, internal docs servers |
+| **Starter** | Minimal MCP server with one example tool | Quick prototypes, custom tools |
 
 ## Install
 
 **As a Claude Code plugin (recommended):**
 
 ```
-Install this plugin: https://github.com/Percona-Lab/easymcp
+Install this plugin: https://github.com/Percona-Lab/claude-plugins
 ```
 
-Then ask Claude: "Create a new MCP server for my docs"
-
-**Or download the plugin zip** from the [latest release](https://github.com/Percona-Lab/easymcp/releases/latest) and extract to `~/.claude/plugins/easymcp/`
+Then ask Claude: "Create a new MCP server" or "Scaffold an API integration for Slack"
 
-**Or run the CLI directly:**
+**Or download and run directly:**
 
 ```bash
-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
+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](https://docs.astral.sh/uv/). Install with: `curl -LsSf https://astral.sh/uv/install.sh | sh`
-
 ## What gets generated
 
+### API integration (Python example)
+
 ```
-acme-docs/
-  install-acme-docs          # Bash bootstrap (curl|bash one-liner)
-  install-acme-docs.ps1      # PowerShell bootstrap (irm|iex one-liner)
-  installer.py               # Cross-platform interactive installer (stdlib only)
-  README.md                  # With install instructions, MCP config examples
-  LICENSE, .gitignore, .env.example
-
-  # Python template:
+slack-mcp/
+  .gitignore, LICENSE, .env.example, README.md
   pyproject.toml
-  src/acme_docs/
-    mcp_server.py             # FastMCP server with auto-refresh
-    ingest.py                 # Incremental ingestion (file hashing, ChromaDB)
-    server.py                 # FastAPI REST API (/search, /health, /stats)
-    source_registry.py        # Keyword-based source suggestions
-
-  # Node.js template:
-  package.json
-  src/
-    mcp-server.js             # @modelcontextprotocol/sdk server
-    ingest.js                 # Ingestion pipeline
-    server.js                 # Express REST API
-    source-registry.js        # Source suggestions
+  src/slack_mcp/
+    connector.py       # API client class with auth + methods
+    mcp_server.py      # FastMCP server wrapping connector as tools
 ```
 
-## How it works
-
-easyMCP is a Python CLI distributed as a wheel via [GitHub releases](https://github.com/Percona-Lab/easymcp/releases). It's also available as a Claude Code plugin through the [Percona claude-plugins marketplace](https://github.com/Percona-Lab/claude-plugins).
+### Doc search (Python example)
 
-Templates use Jinja2 with alternate delimiters (`<% %>` for blocks, `<< >>` for variables) to avoid conflicts with Python `{}` and JavaScript template literals.
+```
+acme-dk/
+  install-acme-dk          # curl|bash one-liner
+  install-acme-dk.ps1      # irm|iex one-liner
+  installer.py             # Cross-platform interactive installer
+  .gitignore, LICENSE, .env.example, README.md
+  pyproject.toml
+  src/acme_dk/
+    mcp_server.py          # FastMCP with auto-refresh
+    ingest.py              # Incremental ingestion pipeline
+    server.py              # FastAPI REST API
+    source_registry.py     # Source suggestions
+```
 
-## Project structure
+### Starter
 
 ```
-easymcp/
-  pyproject.toml              # CLI package
-  src/easymcp/
-    cli.py                    # Click-based CLI
-    scaffold.py               # Template rendering + file output
-    prompts.py                # Interactive prompt helpers
-    template_engine.py        # Jinja2 with alternate delimiters
-    validators.py             # Input validation
-  templates/
-    common/                   # Shared: installer, README, LICENSE, etc.
-    python/                   # Python-specific templates
-    nodejs/                   # Node.js-specific templates
+my-tool/
+  .gitignore, LICENSE, README.md
+  pyproject.toml (or package.json)
+  src/my_tool/mcp_server.py (or src/mcp-server.js)
 ```
 
+## Language support
+
+Both Python (FastMCP) and Node.js (@modelcontextprotocol/sdk) templates for all project types.
+
 ## License
 
 MIT

pyproject.toml

@@ -3,16 +3,16 @@ requires = ["hatchling"]
 build-backend = "hatchling.build"
 
 [project]
-name = "easymcp"
-version = "0.1.0"
-description = "Scaffold production-ready MCP servers with polished cross-platform installers"
+name = "cairn-mcp"
+version = "0.2.0"
+description = "CAIRN — Create Any Integration, Run Naturally. Scaffold production-ready MCP servers."
 readme = "README.md"
 license = "MIT"
 requires-python = ">=3.11"
 authors = [
     { name = "Percona", email = "info@percona.com" },
 ]
-keywords = ["mcp", "model-context-protocol", "scaffolding", "cli", "ai-tools"]
+keywords = ["mcp", "model-context-protocol", "scaffolding", "cli", "ai-tools", "cairn"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Environment :: Console",
@@ -28,18 +28,18 @@ dependencies = [
 ]
 
 [project.scripts]
-easymcp = "easymcp.cli:main"
+cairn = "cairn.cli:main"
 
 [project.urls]
-Homepage = "https://github.com/Percona-Lab/easymcp"
-Repository = "https://github.com/Percona-Lab/easymcp"
-Issues = "https://github.com/Percona-Lab/easymcp/issues"
+Homepage = "https://github.com/Percona-Lab/CAIRN"
+Repository = "https://github.com/Percona-Lab/CAIRN"
+Issues = "https://github.com/Percona-Lab/CAIRN/issues"
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/easymcp"]
+packages = ["src/cairn"]
 
 [tool.hatch.build.targets.wheel.force-include]
-"templates" = "easymcp/templates"
+"templates" = "cairn/templates"
 
 [tool.hatch.build.targets.sdist]
-include = ["src/easymcp", "templates", "README.md", "LICENSE"]
+include = ["src/cairn", "templates", "README.md", "LICENSE"]

src/cairn/__init__.py

@@ -0,0 +1,3 @@
+"""CAIRN — Create Any Integration, Run Naturally. Scaffold production-ready MCP servers."""
+
+__version__ = "0.2.0"

src/easymcp/cli.py src/cairn/cli.pysrc/easymcp/cli.py renamed to src/cairn/cli.py

@@ -1,19 +1,19 @@
-"""easyMCP CLI - scaffold production-ready MCP server projects."""
+"""CAIRN CLI — scaffold production-ready MCP server projects."""
 
 import sys
 from pathlib import Path
 
 import click
 
-from easymcp import __version__
-from easymcp.prompts import run_prompts, c, info, error, BOLD
-from easymcp.scaffold import scaffold
+from cairn import __version__
+from cairn.prompts import run_prompts, c, info, error, BOLD
+from cairn.scaffold import scaffold
 
 
 @click.group()
-@click.version_option(__version__, prog_name="easymcp")
+@click.version_option(__version__, prog_name="cairn")
 def main():
-    """easyMCP - Scaffold production-ready MCP servers with polished installers."""
+    """CAIRN — Create Any Integration, Run Naturally. Scaffold production-ready MCP servers."""
     pass