gridpane-mcp 0.1.0__tar.gz

gridpane_mcp-0.1.0/.env.example

@@ -0,0 +1,2 @@
+GRIDPANE_API_TOKEN=your_api_token_here
+GRIDPANE_API_URL=https://my.gridpane.com/api

gridpane_mcp-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+.env
+__pycache__/
+*.pyc
+venv/
+.venv/
+.DS_Store

gridpane_mcp-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

gridpane_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fenil Patel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

gridpane_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: gridpane-mcp
+Version: 0.1.0
+Summary: MCP server for the GridPane hosting platform API. Manage WordPress servers and sites through Claude, Cursor, or any MCP client.
+Project-URL: Homepage, https://github.com/fenil0020/gridpane-mcp
+Project-URL: Repository, https://github.com/fenil0020/gridpane-mcp
+Project-URL: Issues, https://github.com/fenil0020/gridpane-mcp/issues
+Author-email: Fenil Patel <fenil@supple.com.au>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: gridpane,hosting,mcp,model-context-protocol,wordpress
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp[cli]>=1.2.0
+Description-Content-Type: text/markdown
+
+# gridpane-mcp
+
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for the [GridPane](https://gridpane.com/) hosting platform API. Manage your WordPress servers and sites through Claude, Cursor, or any MCP-compatible client.
+
+## Features
+
+### Server Management
+- **list_servers** — List all servers with IPs, status, and site counts
+- **get_server** — Get detailed server info by ID
+- **search_server** — Find servers by name (partial match)
+- **restart_nginx** — Restart Nginx on a server
+- **restart_php** — Restart PHP-FPM for a specific PHP version
+- **restart_mysql** — Restart MySQL/MariaDB/Percona
+
+### Site Management
+- **list_sites** — List all WordPress sites across all servers
+- **get_site** — Get detailed site info by ID
+- **search_site** — Find sites by domain name (partial match)
+- **toggle_ssl** — Toggle SSL on/off
+- **toggle_site_cache** — Toggle Nginx caching
+- **purge_site_cache** — Purge all server-level caches
+- **toggle_debug** — Toggle WordPress debug mode
+- **change_php_version** — Change PHP version (7.4, 8.0, 8.1, 8.2, 8.3)
+- **get_sso_link** — Get a Single Sign-On link to wp-admin
+- **trigger_backup** — Trigger a manual backup
+
+## Prerequisites
+
+- A [GridPane](https://gridpane.com/) account (Developer plan or above)
+- A GridPane API token (Settings > GridPane API > Create New Token)
+
+## Installation
+
+```bash
+pip install gridpane-mcp
+```
+
+Or with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv pip install gridpane-mcp
+```
+
+## Configuration
+
+Set your GridPane API token as an environment variable:
+
+```bash
+export GRIDPANE_API_TOKEN="your_token_here"
+```
+
+### Claude Code
+
+```bash
+claude mcp add gridpane -e GRIDPANE_API_TOKEN=your_token_here -- gridpane-mcp
+```
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "gridpane": {
+      "command": "gridpane-mcp",
+      "env": {
+        "GRIDPANE_API_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to your Cursor MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "gridpane": {
+      "command": "gridpane-mcp",
+      "env": {
+        "GRIDPANE_API_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+## Usage Examples
+
+Once connected, you can ask your AI assistant things like:
+
+- "List all my GridPane servers"
+- "Find sites with 'supple' in the domain"
+- "Purge cache for site ID 661035"
+- "Restart Nginx on the accesshealth server"
+- "What PHP version is accesshealth.com.au running?"
+- "Toggle debug mode on site 661035"
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `GRIDPANE_API_TOKEN` | (required) | Your GridPane API personal access token |
+| `GRIDPANE_API_URL` | `https://my.gridpane.com/oauth/api/v1` | GridPane API base URL |
+
+## License
+
+MIT

gridpane_mcp-0.1.0/README.md

@@ -0,0 +1,112 @@
+# gridpane-mcp
+
+A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for the [GridPane](https://gridpane.com/) hosting platform API. Manage your WordPress servers and sites through Claude, Cursor, or any MCP-compatible client.
+
+## Features
+
+### Server Management
+- **list_servers** — List all servers with IPs, status, and site counts
+- **get_server** — Get detailed server info by ID
+- **search_server** — Find servers by name (partial match)
+- **restart_nginx** — Restart Nginx on a server
+- **restart_php** — Restart PHP-FPM for a specific PHP version
+- **restart_mysql** — Restart MySQL/MariaDB/Percona
+
+### Site Management
+- **list_sites** — List all WordPress sites across all servers
+- **get_site** — Get detailed site info by ID
+- **search_site** — Find sites by domain name (partial match)
+- **toggle_ssl** — Toggle SSL on/off
+- **toggle_site_cache** — Toggle Nginx caching
+- **purge_site_cache** — Purge all server-level caches
+- **toggle_debug** — Toggle WordPress debug mode
+- **change_php_version** — Change PHP version (7.4, 8.0, 8.1, 8.2, 8.3)
+- **get_sso_link** — Get a Single Sign-On link to wp-admin
+- **trigger_backup** — Trigger a manual backup
+
+## Prerequisites
+
+- A [GridPane](https://gridpane.com/) account (Developer plan or above)
+- A GridPane API token (Settings > GridPane API > Create New Token)
+
+## Installation
+
+```bash
+pip install gridpane-mcp
+```
+
+Or with [uv](https://docs.astral.sh/uv/):
+
+```bash
+uv pip install gridpane-mcp
+```
+
+## Configuration
+
+Set your GridPane API token as an environment variable:
+
+```bash
+export GRIDPANE_API_TOKEN="your_token_here"
+```
+
+### Claude Code
+
+```bash
+claude mcp add gridpane -e GRIDPANE_API_TOKEN=your_token_here -- gridpane-mcp
+```
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "gridpane": {
+      "command": "gridpane-mcp",
+      "env": {
+        "GRIDPANE_API_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to your Cursor MCP settings:
+
+```json
+{
+  "mcpServers": {
+    "gridpane": {
+      "command": "gridpane-mcp",
+      "env": {
+        "GRIDPANE_API_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+## Usage Examples
+
+Once connected, you can ask your AI assistant things like:
+
+- "List all my GridPane servers"
+- "Find sites with 'supple' in the domain"
+- "Purge cache for site ID 661035"
+- "Restart Nginx on the accesshealth server"
+- "What PHP version is accesshealth.com.au running?"
+- "Toggle debug mode on site 661035"
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `GRIDPANE_API_TOKEN` | (required) | Your GridPane API personal access token |
+| `GRIDPANE_API_URL` | `https://my.gridpane.com/oauth/api/v1` | GridPane API base URL |
+
+## License
+
+MIT

gridpane_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "gridpane-mcp"
+version = "0.1.0"
+description = "MCP server for the GridPane hosting platform API. Manage WordPress servers and sites through Claude, Cursor, or any MCP client."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Fenil Patel", email = "fenil@supple.com.au" },
+]
+keywords = ["mcp", "gridpane", "wordpress", "hosting", "model-context-protocol"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Internet :: WWW/HTTP :: Site Management",
+    "Topic :: System :: Systems Administration",
+]
+dependencies = [
+    "httpx>=0.27.0",
+    "mcp[cli]>=1.2.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/fenil0020/gridpane-mcp"
+Repository = "https://github.com/fenil0020/gridpane-mcp"
+Issues = "https://github.com/fenil0020/gridpane-mcp/issues"
+
+[project.scripts]
+gridpane-mcp = "gridpane_mcp.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

gridpane_mcp-0.1.0/src/gridpane_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""GridPane MCP Server — Model Context Protocol server for the GridPane hosting API."""
+
+__version__ = "0.1.0"

gridpane_mcp-0.1.0/src/gridpane_mcp/server.py

@@ -0,0 +1,217 @@
+import json
+import os
+import sys
+import logging
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+API_URL = os.getenv("GRIDPANE_API_URL", "https://my.gridpane.com/oauth/api/v1")
+API_TOKEN = os.getenv("GRIDPANE_API_TOKEN", "")
+
+logging.basicConfig(level=logging.INFO, stream=sys.stderr)
+logger = logging.getLogger("gridpane-mcp")
+
+mcp = FastMCP("gridpane")
+
+
+def _headers():
+    return {
+        "Authorization": f"Bearer {API_TOKEN}",
+        "Accept": "application/json",
+    }
+
+
+async def _get(path: str, params: dict | None = None) -> dict:
+    async with httpx.AsyncClient(timeout=30) as client:
+        r = await client.get(f"{API_URL}/{path}", headers=_headers(), params=params)
+        r.raise_for_status()
+        return r.json()
+
+
+async def _post(path: str, data: dict | None = None) -> dict:
+    async with httpx.AsyncClient(timeout=60) as client:
+        r = await client.post(f"{API_URL}/{path}", headers=_headers(), json=data)
+        r.raise_for_status()
+        return r.json()
+
+
+async def _delete(path: str) -> dict:
+    async with httpx.AsyncClient(timeout=60) as client:
+        r = await client.delete(f"{API_URL}/{path}", headers=_headers())
+        r.raise_for_status()
+        return r.json()
+
+
+# ── Server Tools ──────────────────────────────────────────────
+
+
+@mcp.tool()
+async def list_servers() -> str:
+    """List all GridPane servers with their IPs, status, and site counts."""
+    data = await _get("server", {"per_page": 100})
+    lines = []
+    for s in data["data"]:
+        status = s.get("status") or "unknown"
+        sites = len(s.get("sites", []))
+        lines.append(
+            f'ID: {s["id"]} | {s["label"]:40s} | {s.get("ip",""):16s} | '
+            f'{status:8s} | sites={sites}'
+        )
+    lines.insert(0, f"Total servers: {len(data['data'])}\n")
+    return "\n".join(lines)
+
+
+@mcp.tool()
+async def get_server(server_id: int) -> str:
+    """Get detailed info for a specific server by its ID."""
+    data = await _get(f"server/{server_id}")
+    return json.dumps(data.get("data", data), indent=2)
+
+
+@mcp.tool()
+async def search_server(name: str) -> str:
+    """Search for a server by name (partial match). Returns matching servers with their sites."""
+    data = await _get("server", {"per_page": 100})
+    matches = [s for s in data["data"] if name.lower() in s["label"].lower()]
+    if not matches:
+        return f"No servers found matching '{name}'"
+    lines = []
+    for s in matches:
+        sites = ", ".join(site["url"] for site in s.get("sites", []))
+        lines.append(
+            f'ID: {s["id"]} | {s["label"]} | {s.get("ip","")} | '
+            f'{s.get("status") or "unknown"}\n  Sites: {sites}'
+        )
+    return "\n\n".join(lines)
+
+
+# ── Site Tools ────────────────────────────────────────────────
+
+
+@mcp.tool()
+async def list_sites(per_page: int = 200) -> str:
+    """List all WordPress sites across all servers."""
+    data = await _get("site", {"per_page": per_page})
+    lines = []
+    for s in data["data"]:
+        lines.append(
+            f'ID: {s["id"]} | {s["url"]:50s} | type={s.get("type",""):10s} | '
+            f'php={s.get("php_version","")} | ssl={s.get("is_ssl","")} | '
+            f'server_id={s.get("server_id","")}'
+        )
+    lines.insert(0, f"Total sites: {len(data['data'])}\n")
+    return "\n".join(lines)
+
+
+@mcp.tool()
+async def get_site(site_id: int) -> str:
+    """Get detailed info for a specific site by its ID."""
+    data = await _get(f"site/{site_id}")
+    return json.dumps(data.get("data", data), indent=2)
+
+
+@mcp.tool()
+async def search_site(domain: str) -> str:
+    """Search for a site by domain name (partial match)."""
+    data = await _get("site", {"per_page": 500})
+    matches = [s for s in data["data"] if domain.lower() in s["url"].lower()]
+    if not matches:
+        return f"No sites found matching '{domain}'"
+    lines = []
+    for s in matches:
+        lines.append(
+            f'ID: {s["id"]} | {s["url"]} | type={s.get("type","")} | '
+            f'php={s.get("php_version","")} | ssl={s.get("is_ssl","")} | '
+            f'server_id={s.get("server_id","")}'
+        )
+    return "\n".join(lines)
+
+
+# ── Site Operations ───────────────────────────────────────────
+
+
+@mcp.tool()
+async def toggle_ssl(site_id: int) -> str:
+    """Toggle SSL on/off for a site."""
+    data = await _post(f"site/{site_id}/toggle-ssl")
+    return json.dumps(data, indent=2)
+
+
+@mcp.tool()
+async def toggle_site_cache(site_id: int) -> str:
+    """Toggle Nginx caching for a site."""
+    data = await _post(f"site/{site_id}/toggle-nginx-caching")
+    return json.dumps(data, indent=2)
+
+
+@mcp.tool()
+async def purge_site_cache(site_id: int) -> str:
+    """Purge all server-level caches for a site."""
+    data = await _post(f"site/{site_id}/purge-all-cache")
+    return json.dumps(data, indent=2)
+
+
+@mcp.tool()
+async def toggle_debug(site_id: int) -> str:
+    """Toggle WordPress debug mode for a site."""
+    data = await _post(f"site/{site_id}/toggle-wp-debug")
+    return json.dumps(data, indent=2)
+
+
+@mcp.tool()
+async def change_php_version(site_id: int, php_version: str) -> str:
+    """Change PHP version for a site. Common versions: 7.4, 8.0, 8.1, 8.2, 8.3"""
+    data = await _post(f"site/{site_id}/change-php", {"php_version": php_version})
+    return json.dumps(data, indent=2)
+
+
+# ── SSO / WP Admin ───────────────────────────────────────────
+
+
+@mcp.tool()
+async def get_sso_link(site_id: int) -> str:
+    """Get a Single Sign-On link to access wp-admin for a site."""
+    data = await _post(f"site/{site_id}/sso-link")
+    return json.dumps(data, indent=2)
+
+
+# ── Backup Tools ──────────────────────────────────────────────
+
+
+@mcp.tool()
+async def trigger_backup(site_id: int) -> str:
+    """Trigger a manual backup for a site."""
+    data = await _post(f"site/{site_id}/backup")
+    return json.dumps(data, indent=2)
+
+
+# ── Server Operations ────────────────────────────────────────
+
+
+@mcp.tool()
+async def restart_nginx(server_id: int) -> str:
+    """Restart Nginx on a server."""
+    data = await _post(f"server/{server_id}/restart-nginx")
+    return json.dumps(data, indent=2)
+
+
+@mcp.tool()
+async def restart_php(server_id: int, php_version: str = "8.1") -> str:
+    """Restart PHP-FPM on a server for a specific PHP version."""
+    data = await _post(f"server/{server_id}/restart-php", {"php_version": php_version})
+    return json.dumps(data, indent=2)
+
+
+@mcp.tool()
+async def restart_mysql(server_id: int) -> str:
+    """Restart MySQL/MariaDB/Percona on a server."""
+    data = await _post(f"server/{server_id}/restart-mysql")
+    return json.dumps(data, indent=2)
+
+
+def main():
+    mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()