qiloback-mcp 0.3.2__tar.gz

qiloback_mcp-0.3.2/.gitignore

@@ -0,0 +1,64 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+*.egg-info/
+dist/
+build/
+*.egg
+.venv/
+venv/
+
+# uv
+.python-version
+
+# Testing
+.coverage
+htmlcov/
+.pytest_cache/
+
+# Environment
+.env
+.env.local
+.env.production
+
+# Secrets (JWT keys, signing material)
+.keys/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Node (admin panel)
+node_modules/
+.next/
+out/
+.turbo/
+
+# Generated output
+generated/*/
+
+# Docker
+*.log
+
+# Lock files for generated projects
+# (the platform's own lock files are tracked)
+generated/**/.bp-lock.json
+
+# Database
+*.db
+*.sqlite3
+tsconfig.tsbuildinfo
+docs/internal/
+
+# uv.lock and pnpm-lock.yaml are committed for reproducibility — see
+# Renovate / Dependabot config for the bot-driven update cadence.
+wrappers/pip/.venv
+wrappers/pip/uv.lock

qiloback_mcp-0.3.2/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: qiloback-mcp
+Version: 0.3.2
+Summary: QiloBack MCP Server — AI tool integration for backend manufacturing
+Project-URL: Homepage, https://qiloback.dev
+Project-URL: Repository, https://github.com/delixon-labs/delixon-qiloback
+Author: XPlus Technologies LLC
+License: FSL-1.1-ALv2
+Keywords: ai,backend,code-generation,mcp,qiloback,tool
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.12
+Requires-Dist: fastmcp>=2.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: pyyaml>=6.0
+Description-Content-Type: text/markdown
+
+# qiloback-mcp
+
+MCP (Model Context Protocol) server for QiloBack. Lets AI agents
+(Claude Code, Cursor, Windsurf, ChatGPT Desktop, …) drive a QiloBack
+platform-api as a first-class tool.
+
+## Install
+
+```bash
+pip install qiloback-mcp     # or: uvx qiloback-mcp
+```
+
+## Configure (Claude Code)
+
+```bash
+claude mcp add qiloback -- uvx qiloback-mcp
+```
+
+Set the platform endpoint and (optional) bearer token via environment:
+
+```bash
+export QILOBACK_API_URL=http://localhost:8001
+export QILOBACK_API_TOKEN=…
+```
+
+## Tools
+
+The server exposes tools across six groups:
+
+- **Project** — `create_project`, `get_project`, `list_projects`,
+  `delete_project`, `eject_project`
+- **DSL** — `get_project_dsl`, `update_dsl`, `validate_dsl`,
+  `diff_dsl`, `add_entity`, `list_templates`
+- **Codegen** — `generate_backend`, `list_generations`,
+  `get_generation`, `generate_sdk`, `scan_frontend`
+- **Migration** — `migration_status`
+- **Operations** — `health_check`, `get_audit_events`, `get_metrics`
+- **AI** — `ai_generate_dsl`, `review_dsl`, `suggest_indexes`
+
+The most opinionated tool is `eject_project`: it returns a portable
+zip with the FastAPI source, a Dockerfile, a docker-compose stack and
+a deploy README — runs anywhere with no QiloBack runtime dependency.
+The artefacts inside the bundle are released under Apache 2.0; the
+QiloBack license stays on the generator, not on its output.
+
+## License
+
+`qiloback-mcp` itself ships under FSL-1.1-ALv2 — source-available
+during the FSL window, automatic conversion to Apache 2.0 two years
+after each release. See the QiloBack
+[LICENSE-FAQ.md](https://github.com/delixon-labs/delixon-qiloback/blob/main/LICENSE-FAQ.md)
+for the full picture.

qiloback_mcp-0.3.2/README.md

@@ -0,0 +1,52 @@
+# qiloback-mcp
+
+MCP (Model Context Protocol) server for QiloBack. Lets AI agents
+(Claude Code, Cursor, Windsurf, ChatGPT Desktop, …) drive a QiloBack
+platform-api as a first-class tool.
+
+## Install
+
+```bash
+pip install qiloback-mcp     # or: uvx qiloback-mcp
+```
+
+## Configure (Claude Code)
+
+```bash
+claude mcp add qiloback -- uvx qiloback-mcp
+```
+
+Set the platform endpoint and (optional) bearer token via environment:
+
+```bash
+export QILOBACK_API_URL=http://localhost:8001
+export QILOBACK_API_TOKEN=…
+```
+
+## Tools
+
+The server exposes tools across six groups:
+
+- **Project** — `create_project`, `get_project`, `list_projects`,
+  `delete_project`, `eject_project`
+- **DSL** — `get_project_dsl`, `update_dsl`, `validate_dsl`,
+  `diff_dsl`, `add_entity`, `list_templates`
+- **Codegen** — `generate_backend`, `list_generations`,
+  `get_generation`, `generate_sdk`, `scan_frontend`
+- **Migration** — `migration_status`
+- **Operations** — `health_check`, `get_audit_events`, `get_metrics`
+- **AI** — `ai_generate_dsl`, `review_dsl`, `suggest_indexes`
+
+The most opinionated tool is `eject_project`: it returns a portable
+zip with the FastAPI source, a Dockerfile, a docker-compose stack and
+a deploy README — runs anywhere with no QiloBack runtime dependency.
+The artefacts inside the bundle are released under Apache 2.0; the
+QiloBack license stays on the generator, not on its output.
+
+## License
+
+`qiloback-mcp` itself ships under FSL-1.1-ALv2 — source-available
+during the FSL window, automatic conversion to Apache 2.0 two years
+after each release. See the QiloBack
+[LICENSE-FAQ.md](https://github.com/delixon-labs/delixon-qiloback/blob/main/LICENSE-FAQ.md)
+for the full picture.

qiloback_mcp-0.3.2/pyproject.toml

@@ -0,0 +1,43 @@
+[project]
+name = "qiloback-mcp"
+version = "0.3.2"
+description = "QiloBack MCP Server — AI tool integration for backend manufacturing"
+readme = "README.md"
+license = {text = "FSL-1.1-ALv2"}
+authors = [{name = "XPlus Technologies LLC"}]
+requires-python = ">=3.12"
+keywords = ["qiloback", "mcp", "ai", "tool", "backend", "code-generation"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: Other/Proprietary License",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = [
+    "fastmcp>=2.0",
+    "httpx>=0.27",
+    "pyyaml>=6.0",
+]
+
+[project.scripts]
+qiloback-mcp = "qiloback_mcp.server:main"
+
+[project.urls]
+Homepage = "https://qiloback.dev"
+Repository = "https://github.com/delixon-labs/delixon-qiloback"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/qiloback_mcp"]
+
+[dependency-groups]
+dev = ["pytest>=8.0", "pytest-asyncio>=0.23", "pytest-cov>=5.0"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+addopts = "-q --strict-markers"
+pythonpath = ["src", "tests"]

qiloback_mcp-0.3.2/src/qiloback_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""QiloBack MCP Server — AI tool integration for backend manufacturing."""
+
+__version__ = "0.1.0"

qiloback_mcp-0.3.2/src/qiloback_mcp/server.py

@@ -0,0 +1,106 @@
+"""QiloBack MCP Server — exposes QiloBack platform as AI tools.
+
+Connects to the Platform API (default: http://localhost:8001) and provides
+tools for creating projects, managing entities, generating backends, and more.
+
+Usage:
+    # Run directly
+    qiloback-mcp
+
+    # Add to Claude Code
+    claude mcp add qiloback -- uvx qiloback-mcp
+
+    # Environment variables:
+    #   QILOBACK_API_URL   — Platform API URL (default: http://localhost:8001)
+    #   QILOBACK_API_TOKEN — Bearer token for API auth (optional)
+"""
+
+from __future__ import annotations
+
+from fastmcp import FastMCP
+
+from qiloback_mcp.tools import (
+    add_entity,
+    ai_generate_dsl,
+    create_project,
+    delete_project,
+    diff_dsl,
+    eject_project,
+    generate_backend,
+    generate_sdk,
+    get_audit_events,
+    get_component,
+    get_generation,
+    get_metrics,
+    get_project,
+    get_project_dsl,
+    health_check,
+    list_components,
+    list_generations,
+    list_projects,
+    list_templates,
+    migration_status,
+    review_dsl,
+    scan_frontend,
+    suggest_indexes,
+    update_dsl,
+    validate_dsl,
+)
+
+mcp = FastMCP(
+    "QiloBack",
+    instructions=(
+        "Backend manufacturing platform. Create, configure, and generate "
+        "production-grade FastAPI backends from YAML DSL definitions. "
+        "Bundle and download the result with the eject tool — no "
+        "QiloBack runtime dependency on the deployed backend."
+    ),
+)
+
+# Project group
+mcp.tool()(create_project)
+mcp.tool()(get_project)
+mcp.tool()(list_projects)
+mcp.tool()(delete_project)
+mcp.tool()(eject_project)
+
+# DSL group
+mcp.tool()(get_project_dsl)
+mcp.tool()(update_dsl)
+mcp.tool()(validate_dsl)
+mcp.tool()(diff_dsl)
+mcp.tool()(add_entity)
+mcp.tool()(list_templates)
+
+# Codegen group
+mcp.tool()(generate_backend)
+mcp.tool()(list_generations)
+mcp.tool()(get_generation)
+mcp.tool()(generate_sdk)
+mcp.tool()(scan_frontend)
+
+# Migration group
+mcp.tool()(migration_status)
+
+# Operations group
+mcp.tool()(health_check)
+mcp.tool()(get_audit_events)
+mcp.tool()(get_metrics)
+
+# AI group
+mcp.tool()(ai_generate_dsl)
+mcp.tool()(review_dsl)
+mcp.tool()(suggest_indexes)
+
+# Marketplace group
+mcp.tool()(list_components)
+mcp.tool()(get_component)
+
+
+def main() -> None:
+    """Entry point for the MCP server."""
+    mcp.run()
+
+
+if __name__ == "__main__":  # pragma: no cover — script-mode entry shim
+    main()