kaax-mcp 0.1.1 → 0.1.2

package/README.md

@@ -82,17 +82,29 @@ The full list:
 - `kaax_organize_data` — audit and clean up tags
 - `kaax_import_shapefile` — convert + upload .shp parcels
 
-## Install
+## Install (the one-liner)
 
 ```bash
-git clone https://github.com/Ahau-x/Kaax-LandingPage.git
-cd Kaax-LandingPage/mcp
-npm install
-npm run build
+npx -y kaax-mcp init
 ```
 
-The build emits a runnable `dist/index.js` you can invoke directly via
-`node dist/index.js` or — once published — `npx -y @kaax/mcp-server`.
+That's it. The installer auto-detects every MCP client you have installed
+(Claude Desktop, Claude Code, Cursor, Windsurf), asks which ones to wire
+Kaax into, and edits their config for you — non-destructively, preserving
+every other MCP server you already had configured. A `.bak` is written
+next to each file the first time it's touched.
+
+After the installer finishes, **restart your MCP client** and try:
+
+```
+"Crea cuenta en Kaax y guíame paso a paso"
+```
+
+For scripted / CI use, skip the prompts:
+
+```bash
+npx -y kaax-mcp init --yes
+```
 
 ## Configure
 
@@ -108,52 +120,30 @@ The build emits a runnable `dist/index.js` you can invoke directly via
    binds it to the session. Save the key from the tool output so you don't
    have to onboard again next time.
 
-### Claude Desktop
+### Manual config (if you'd rather skip the installer)
 
-Edit `~/Library/Application Support/Claude/claude_desktop_config.json` on
-macOS or `%APPDATA%\Claude\claude_desktop_config.json` on Windows:
+Paste this block into your MCP client's config and restart:
 
 ```json
 {
   "mcpServers": {
     "kaax": {
-      "command": "node",
-      "args": ["C:/path/to/Kaax-LandingPage/mcp/dist/index.js"],
+      "command": "npx",
+      "args": ["-y", "kaax-mcp"],
       "env": {
-        "KAAX_API_KEY": "your_api_key_here"
+        "KAAX_API_KEY": "",
+        "KAAX_LOCALE": "es"
       }
     }
   }
 }
 ```
 
-Restart Claude Desktop. The Kaax tools appear in the tool picker.
-
-### Claude Code
-
-Add to `.mcp.json` at the root of any project (or `~/.claude/mcp.json` for
-all projects):
-
-```json
-{
-  "mcpServers": {
-    "kaax": {
-      "command": "node",
-      "args": ["/absolute/path/to/Kaax-LandingPage/mcp/dist/index.js"],
-      "env": { "KAAX_API_KEY": "your_api_key_here" }
-    }
-  }
-}
-```
-
-### Cursor
-
-`Settings → MCP → Add new MCP server`. Use the same `command` / `args` /
-`env` shape as above.
-
-### Windsurf
-
-`Settings → Cascade → MCP Servers → Add new`. Same payload.
+Config file locations:
+- **Claude Desktop**: `%APPDATA%\Claude\claude_desktop_config.json` (Windows) · `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
+- **Claude Code**: `~/.claude.json` (global) or `.mcp.json` (project root)
+- **Cursor**: `~/.cursor/mcp.json`
+- **Windsurf**: `~/.codeium/windsurf/mcp_config.json`
 
 ### Zed
 
@@ -163,8 +153,8 @@ Add to `~/.config/zed/settings.json`:
 {
   "context_servers": {
     "kaax": {
-      "command": { "path": "node", "args": ["…/mcp/dist/index.js"] },
-      "env": { "KAAX_API_KEY": "your_api_key_here" }
+      "command": { "path": "npx", "args": ["-y", "kaax-mcp"] },
+      "env": { "KAAX_LOCALE": "es" }
     }
   }
 }
@@ -229,30 +219,6 @@ or the short version below:
 - Shapefile conversion is local file I/O — your .shp never leaves your
   machine.
 
-## Develop
-
-```bash
-npm run dev   # tsx watch on src/index.ts
-npm run build # tsc → dist/
-```
-
-Type-check only: `npx tsc --noEmit`.
-
-## Architecture
-
-```
-mcp/src/
-├── index.ts      stdio bootstrap — wires tools, resources, prompts
-├── client.ts     HTTP wrapper + standalone onboarding helpers
-├── tools.ts      19 callable tools
-├── resources.ts  7 markdown docs served as MCP resources
-├── prompts.ts    5 guided conversation starters
-├── spatial.ts    Haversine, KML centroid, cosine, density aggregation
-├── convert.ts    shapefile → KML in pure JS (no GDAL)
-├── platform.ts   openBrowser + streaming file download (no extra deps)
-└── types.ts      shared types for v0, v2 and landing shapes
-```
-
 ## Performance & resource use
 
 The MCP is engineered to stay light:
@@ -269,6 +235,11 @@ The MCP is engineered to stay light:
 - **Detached child processes** — `openBrowser` spawns + `unref`s the
   browser so the MCP exits cleanly even if you leave the browser open.
 
+## Support
+
+- Email: support@kaax-agritech.com
+- Website: https://www.kaax-agritech.com
+
 ## License
 
-MIT — see [LICENSE](../LICENSE).
+MIT.

package/dist/index.js

@@ -30,7 +30,7 @@ import { buildResources } from "./resources.js";
 import { buildPrompts } from "./prompts.js";
 import { runInit } from "./init.js";
 const SERVER_NAME = "kaax-mcp";
-const SERVER_VERSION = "0.1.1";
+const SERVER_VERSION = "0.1.2";
 function bail(msg) {
     // stderr only — MCP clients pipe stdout for protocol traffic.
     process.stderr.write(`[${SERVER_NAME}] ${msg}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kaax-mcp",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "MCP server for Kaax — one-liner installer (`npx -y kaax-mcp init`) that wires Kaax into Claude Desktop, Claude Code, Cursor and Windsurf. Onboards new users, queries analyses, suggests configurations, converts shapefiles to KML and guides downloads.",
   "type": "module",
   "bin": {
@@ -32,14 +32,9 @@
   ],
   "author": "Kaax · Ahau-x <support@kaax-agritech.com>",
   "license": "MIT",
-  "homepage": "https://github.com/Ahau-x/Kaax-LandingPage/tree/main/mcp#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Ahau-x/Kaax-LandingPage.git",
-    "directory": "mcp"
-  },
+  "homepage": "https://www.kaax-agritech.com",
   "bugs": {
-    "url": "https://github.com/Ahau-x/Kaax-LandingPage/issues"
+    "email": "support@kaax-agritech.com"
   },
   "engines": {
     "node": ">=18.0.0"