fleethost-mcp 0.1.0__tar.gz

fleethost_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: fleethost-mcp
+Version: 0.1.0
+Summary: MCP server for Fleet hosting platform — deploy apps and databases from any MCP-compatible agent
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.6.0
+Requires-Dist: httpx>=0.28.0
+
+# fleethost-mcp
+
+MCP server for [Fleet](https://fleethost.space) — deploy applications and databases from any MCP-compatible agent (Claude CLI, Cline, opencode, etc.).
+
+## Installation
+
+```bash
+pip install fleethost-mcp
+```
+
+## Configuration
+
+Add to your agent's MCP config:
+
+```json
+{
+  "mcpServers": {
+    "fleet": {
+      "command": "fleethost-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+## Usage
+
+1. Start a conversation with your agent
+2. Say: "Deploy my app to Fleet"
+3. Agent will ask for your Fleet credentials once
+4. Token is cached for future sessions
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `login` | Authenticate with your Fleet account |
+| `deploy_app` | Deploy a new application |
+| `list_apps` | List all your applications |
+| `get_app_status` | Get live deployment status |
+| `get_app_logs` | Fetch deployment or runtime logs |
+| `redeploy_app` | Trigger a redeploy |
+| `update_envs` | Set environment variables |
+| `deploy_database` | Deploy a database (PostgreSQL, MySQL, MongoDB, Redis) |
+| `list_databases` | List all your databases |
+| `get_vps_info` | View VPS info and storage usage |
+| `get_user_info` | View your Fleet profile |

fleethost_mcp-0.1.0/README.md

@@ -0,0 +1,47 @@
+# fleethost-mcp
+
+MCP server for [Fleet](https://fleethost.space) — deploy applications and databases from any MCP-compatible agent (Claude CLI, Cline, opencode, etc.).
+
+## Installation
+
+```bash
+pip install fleethost-mcp
+```
+
+## Configuration
+
+Add to your agent's MCP config:
+
+```json
+{
+  "mcpServers": {
+    "fleet": {
+      "command": "fleethost-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+## Usage
+
+1. Start a conversation with your agent
+2. Say: "Deploy my app to Fleet"
+3. Agent will ask for your Fleet credentials once
+4. Token is cached for future sessions
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `login` | Authenticate with your Fleet account |
+| `deploy_app` | Deploy a new application |
+| `list_apps` | List all your applications |
+| `get_app_status` | Get live deployment status |
+| `get_app_logs` | Fetch deployment or runtime logs |
+| `redeploy_app` | Trigger a redeploy |
+| `update_envs` | Set environment variables |
+| `deploy_database` | Deploy a database (PostgreSQL, MySQL, MongoDB, Redis) |
+| `list_databases` | List all your databases |
+| `get_vps_info` | View VPS info and storage usage |
+| `get_user_info` | View your Fleet profile |

fleethost_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[project]
+name = "fleethost-mcp"
+version = "0.1.0"
+description = "MCP server for Fleet hosting platform — deploy apps and databases from any MCP-compatible agent"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+dependencies = [
+    "mcp>=1.6.0",
+    "httpx>=0.28.0",
+]
+
+[project.scripts]
+fleet-mcp = "fleet_mcp:main"
+
+[build-system]
+requires = ["setuptools>=75.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]

fleethost_mcp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

fleethost_mcp-0.1.0/src/fleet_mcp/__init__.py

@@ -0,0 +1,3 @@
+from fleet_mcp.server import main
+
+__all__ = ["main"]

fleethost_mcp-0.1.0/src/fleet_mcp/__main__.py

@@ -0,0 +1,3 @@
+from fleet_mcp import main
+
+main()

fleethost_mcp-0.1.0/src/fleet_mcp/server.py

@@ -0,0 +1,230 @@
+import json
+import os
+import sys
+from pathlib import Path
+
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+FLEET_API_URL = os.environ.get("FLEET_API_URL", "https://fleet-host.fastapicloud.dev")
+TOKEN_FILE = Path.home() / ".config" / "fleet-mcp" / "token"
+
+mcp = FastMCP("fleet-mcp")
+
+
+def _load_token() -> str | None:
+    if TOKEN_FILE.exists():
+        return TOKEN_FILE.read_text().strip()
+    return None
+
+
+def _save_token(token: str):
+    TOKEN_FILE.parent.mkdir(parents=True, exist_ok=True)
+    TOKEN_FILE.write_text(token)
+
+
+def _get_headers() -> dict:
+    token = _load_token()
+    if not token:
+        raise RuntimeError(
+            "Not authenticated. Please use the `login` tool first with your Fleet email and password."
+        )
+    return {
+        "Authorization": f"Bearer {token}",
+        "Content-Type": "application/json",
+        "Accept": "application/json",
+    }
+
+
+def _api_call(method: str, path: str, **kwargs) -> dict:
+    url = f"{FLEET_API_URL}{path}"
+    with httpx.Client(timeout=60.0, verify=False) as client:
+        resp = client.request(method, url, **kwargs)
+        if resp.status_code == 401:
+            raise RuntimeError(
+                "Authentication expired or invalid. Please use the `login` tool again."
+            )
+        resp.raise_for_status()
+        return resp.json()
+
+
+@mcp.tool()
+def login(email: str, password: str) -> str:
+    """Authenticate with Fleet using your email and password. The token is cached for future sessions."""
+    payload = {"email": email, "password": password}
+    data = _api_call("POST", "/api/login", json=payload)
+    token = data.get("access_token")
+    if not token:
+        return f"Login failed: {data}"
+    _save_token(token)
+    return "Successfully authenticated with Fleet. Token cached for future sessions."
+
+
+@mcp.tool()
+def deploy_app(
+    repo_url: str,
+    name: str,
+    branch: str = "main",
+    port: int = 3000,
+    env_vars: str | None = None,
+    build_command: str | None = None,
+    start_command: str | None = None,
+    custom_domain: str | None = None,
+    install_command: str | None = None,
+    use_build_cache: bool = True,
+) -> str:
+    """Deploy a new application to Fleet from a GitHub repository.
+
+    Args:
+        repo_url: Full HTTPS clone URL of the GitHub repo (e.g. https://github.com/owner/repo.git)
+        name: A name for your application
+        branch: Git branch to deploy (default: main)
+        port: Internal port your app listens on (default: 3000)
+        env_vars: JSON string of environment variables as key-value pairs (e.g. [{"key":"NODE_ENV","value":"production"}])
+        build_command: Custom build command (e.g. npm run build)
+        start_command: Custom start command (e.g. npm start)
+        custom_domain: Custom domain (DNS must already point to your VPS)
+        install_command: Custom install command (e.g. npm install)
+        use_build_cache: Whether to use build cache (default: true)
+    """
+    payload = {
+        "repo_url": repo_url,
+        "name": name,
+        "branch": branch,
+        "port": port,
+        "use_build_cache": use_build_cache,
+    }
+    if env_vars:
+        try:
+            payload["env_vars"] = json.loads(env_vars)
+        except json.JSONDecodeError:
+            return f"Invalid JSON for env_vars: {env_vars}"
+    if build_command:
+        payload["build_command"] = build_command
+    if start_command:
+        payload["start_command"] = start_command
+    if custom_domain:
+        payload["custom_domain"] = custom_domain
+    if install_command:
+        payload["install_command"] = install_command
+
+    data = _api_call("POST", "/api/apps/deploy", json=payload, headers=_get_headers())
+    return json.dumps(data, indent=2)
+
+
+@mcp.tool()
+def list_apps() -> str:
+    """List all your deployed applications and their current status."""
+    data = _api_call("GET", "/api/apps", headers=_get_headers())
+    if not data.get("apps"):
+        return "No applications deployed yet."
+    result = []
+    for app in data["apps"]:
+        result.append(f"- {app['name']} ({app['status']}) — {app.get('domain', 'no domain')}")
+    return "\n".join(result)
+
+
+@mcp.tool()
+def get_app_status(app_id: int) -> str:
+    """Get the live deployment status of an application.
+
+    Args:
+        app_id: The numeric ID of the application
+    """
+    data = _api_call("GET", f"/api/apps/{app_id}/status", headers=_get_headers())
+    return json.dumps(data, indent=2)
+
+
+@mcp.tool()
+def get_app_logs(app_id: int, log_type: str = "deployment") -> str:
+    """Fetch logs for an application.
+
+    Args:
+        app_id: The numeric ID of the application
+        log_type: Type of logs to fetch — 'deployment' for build logs, 'runtime' for live app logs
+    """
+    data = _api_call(
+        "GET", f"/api/apps/{app_id}/logs?log_type={log_type}", headers=_get_headers()
+    )
+    return data.get("logs", json.dumps(data, indent=2))
+
+
+@mcp.tool()
+def redeploy_app(app_id: int, force: bool = False) -> str:
+    """Trigger a redeploy of an existing application.
+
+    Args:
+        app_id: The numeric ID of the application to redeploy
+        force: If true, force a rebuild without cache
+    """
+    params = f"?force={'true' if force else 'false'}"
+    data = _api_call("POST", f"/api/apps/{app_id}/redeploy{params}", headers=_get_headers())
+    return data.get("message", json.dumps(data, indent=2))
+
+
+@mcp.tool()
+def update_envs(app_id: int, env_vars: str) -> str:
+    """Set environment variables for an application. Replaces all existing variables.
+
+    Args:
+        app_id: The numeric ID of the application
+        env_vars: JSON string of environment variables, e.g. [{"key":"DATABASE_URL","value":"postgres://..."}]
+    """
+    try:
+        envs = json.loads(env_vars)
+    except json.JSONDecodeError:
+        return f"Invalid JSON: {env_vars}"
+    data = _api_call(
+        "POST", f"/api/apps/{app_id}/envs", json={"envs": envs}, headers=_get_headers()
+    )
+    return data.get("message", json.dumps(data, indent=2))
+
+
+@mcp.tool()
+def deploy_database(
+    name: str,
+    db_type: str = "postgresql",
+    password: str | None = None,
+) -> str:
+    """Deploy a new database to Fleet.
+
+    Args:
+        name: A name for your database
+        db_type: Type of database — postgresql, mysql, mongodb, or redis
+        password: Optional password. If blank, Fleet auto-generates a secure one.
+    """
+    payload = {"name": name, "db_type": db_type}
+    if password:
+        payload["password"] = password
+    data = _api_call("POST", "/api/databases/deploy", json=payload, headers=_get_headers())
+    return json.dumps(data, indent=2)
+
+
+@mcp.tool()
+def list_databases() -> str:
+    """List all your deployed databases and their status."""
+    data = _api_call("GET", "/api/databases", headers=_get_headers())
+    if not data.get("databases"):
+        return "No databases deployed yet."
+    result = []
+    for db in data["databases"]:
+        result.append(f"- {db['name']} ({db['db_type']}) — {db.get('status', 'unknown')}")
+    return "\n".join(result)
+
+
+@mcp.tool()
+def get_vps_info() -> str:
+    """View your VPS information including IP address, specs, and storage usage."""
+    data = _api_call("GET", "/api/vps/info", headers=_get_headers())
+    return json.dumps(data, indent=2)
+
+
+@mcp.tool()
+def get_user_info() -> str:
+    """View your Fleet account profile and usage summary."""
+    data = _api_call("GET", "/api/user/me", headers=_get_headers())
+    return json.dumps(data, indent=2)
+
+
+def main():
+    mcp.run()

fleethost_mcp-0.1.0/src/fleethost_mcp.egg-info/PKG-INFO

@@ -0,0 +1,57 @@
+Metadata-Version: 2.4
+Name: fleethost-mcp
+Version: 0.1.0
+Summary: MCP server for Fleet hosting platform — deploy apps and databases from any MCP-compatible agent
+License-Expression: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.6.0
+Requires-Dist: httpx>=0.28.0
+
+# fleethost-mcp
+
+MCP server for [Fleet](https://fleethost.space) — deploy applications and databases from any MCP-compatible agent (Claude CLI, Cline, opencode, etc.).
+
+## Installation
+
+```bash
+pip install fleethost-mcp
+```
+
+## Configuration
+
+Add to your agent's MCP config:
+
+```json
+{
+  "mcpServers": {
+    "fleet": {
+      "command": "fleethost-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+## Usage
+
+1. Start a conversation with your agent
+2. Say: "Deploy my app to Fleet"
+3. Agent will ask for your Fleet credentials once
+4. Token is cached for future sessions
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `login` | Authenticate with your Fleet account |
+| `deploy_app` | Deploy a new application |
+| `list_apps` | List all your applications |
+| `get_app_status` | Get live deployment status |
+| `get_app_logs` | Fetch deployment or runtime logs |
+| `redeploy_app` | Trigger a redeploy |
+| `update_envs` | Set environment variables |
+| `deploy_database` | Deploy a database (PostgreSQL, MySQL, MongoDB, Redis) |
+| `list_databases` | List all your databases |
+| `get_vps_info` | View VPS info and storage usage |
+| `get_user_info` | View your Fleet profile |

fleethost_mcp-0.1.0/src/fleethost_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+src/fleet_mcp/__init__.py
+src/fleet_mcp/__main__.py
+src/fleet_mcp/server.py
+src/fleethost_mcp.egg-info/PKG-INFO
+src/fleethost_mcp.egg-info/SOURCES.txt
+src/fleethost_mcp.egg-info/dependency_links.txt
+src/fleethost_mcp.egg-info/entry_points.txt
+src/fleethost_mcp.egg-info/requires.txt
+src/fleethost_mcp.egg-info/top_level.txt

fleethost_mcp-0.1.0/src/fleethost_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fleethost_mcp-0.1.0/src/fleethost_mcp.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fleet-mcp = fleet_mcp:main

fleethost_mcp-0.1.0/src/fleethost_mcp.egg-info/requires.txt

@@ -0,0 +1,2 @@
+mcp>=1.6.0
+httpx>=0.28.0

fleethost_mcp-0.1.0/src/fleethost_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+fleet_mcp