docs(mcp): improve MCP setup for beginners across all AI tools

- Rewrote mcp_server/README.md with step-by-step guides for Claude Code,
  Claude Desktop, Cursor, VS Code Copilot, Windsurf, and Zed
- Added tools table entry for generate_unittest_config (was missing)
- Added troubleshooting section for common setup failures
- Fixed setup_devops_os_mcp.sh: replaced hardcoded ~/gsdev path with
  configurable INSTALL_DIR (default ~/devops_os), added --local flag
  for users already inside a clone, added --help and Python version check
- Added .mcp.json (Claude Code project-level config)
- Added .cursor/mcp.json (Cursor IDE project-level config)
- Added .vscode/mcp.json (VS Code Copilot project-level config)
- Updated .gitignore to track IDE MCP configs while ignoring personal settings
- Removed "WIP" label from MCP section in main README.md, added curl one-liner

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: chefgs

.cursor/mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "devops-os": {
+      "command": ".venv/bin/python",
+      "args": ["-m", "mcp_server.server"],
+      "cwd": ".",
+      "env": {
+        "PYTHONPATH": "."
+      }
+    }
+  }
+}

.gitignore

@@ -62,10 +62,15 @@ pytestdebug.log
 *.iws
 .idea_modules/
 
-# VS Code
-.vscode/
+# VS Code (ignore personal settings, track shared MCP config)
+.vscode/*
+!.vscode/mcp.json
 *.code-workspace
 
+# Cursor (ignore personal settings, track shared MCP config)
+.cursor/*
+!.cursor/mcp.json
+
 # Spyder
 .spyderproject
 .spyproject

.mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "devops-os": {
+      "command": ".venv/bin/python",
+      "args": ["-m", "mcp_server.server"],
+      "env": {
+        "PYTHONPATH": "."
+      }
+    }
+  }
+}

.vscode/mcp.json

@@ -0,0 +1,13 @@
+{
+  "servers": {
+    "devops-os": {
+      "type": "stdio",
+      "command": ".venv/bin/python",
+      "args": ["-m", "mcp_server.server"],
+      "cwd": ".",
+      "env": {
+        "PYTHONPATH": "."
+      }
+    }
+  }
+}

README.md

@@ -209,17 +209,28 @@ Single Cli Command for Platform Engineering Capabilities - Dev Container and CIC
 
 ---
 
-### 6 — Use with AI (MCP Server) - **WIP**
+### 6 — Use with AI (MCP Server)
+
+Connect DevOps-OS tools to any MCP-compatible AI assistant: **Claude Code, Claude Desktop, Cursor, VS Code Copilot, Windsurf, and Zed**.
+
+**Fastest setup (Claude Code CLI):**
 
 ```bash
-pip install -r mcp_server/requirements.txt
-python mcp_server/server.py
+curl -fsSL https://raw.githubusercontent.com/cloudengine-labs/devops_os/main/mcp_server/setup_devops_os_mcp.sh | bash
 ```
 
-Add to your `claude_desktop_config.json` and ask Claude:
-> *"Generate a complete CI/CD GitHub Actions workflow for my Python API with Kubernetes deployment using ArgoCD."*
+Already cloned the repo? Run locally instead:
+
+```bash
+bash mcp_server/setup_devops_os_mcp.sh --local
+```
+
+Then ask your AI assistant:
+> *"Generate a complete GitHub Actions CI/CD workflow for my Python API with Kubernetes deployment using ArgoCD."*
+
+**[Full setup guide →](mcp_server/README.md)** — covers Claude Desktop, Cursor, VS Code, Windsurf, Zed, and troubleshooting.
 
-See **[mcp_server/README.md](mcp_server/README.md)** for full setup and **[skills/README.md](skills/README.md)** for Claude API & OpenAI function-calling examples.
+See **[skills/README.md](skills/README.md)** for Claude API & OpenAI function-calling examples.
 
 ---