synfig-mcp 1.0.3__tar.gz

synfig_mcp-1.0.3/.gitignore

@@ -0,0 +1,40 @@
+# Git
+.git/
+
+# Build directories
+build_synfig/
+synfig_upstream/
+cmake-build/
+*.o
+*.obj
+*.exe
+*.dll
+*.a
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+.venv/
+venv/
+dist/
+build/
+site/
+*.egg-info/
+.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+.coverage
+htmlcov/
+
+# IDE
+.vscode/
+.idea/
+
+# Operating system
+Thumbs.db
+[Dd]esktop.ini
+$RECYCLE.BIN/
+*.log
+scratch/
+

synfig_mcp-1.0.3/PKG-INFO

@@ -0,0 +1,137 @@
+Metadata-Version: 2.5
+Name: synfig-mcp
+Version: 1.0.3
+Summary: Live MCP control of Synfig Studio (native bridge + headless fallback)
+Project-URL: Homepage, https://github.com/anusara-bemal/synfig-mcp
+Project-URL: Documentation, https://github.com/anusara-bemal/synfig-mcp/tree/v1.0.0/docs
+Project-URL: Repository, https://github.com/anusara-bemal/synfig-mcp
+Project-URL: Issues, https://github.com/anusara-bemal/synfig-mcp/issues
+Project-URL: Changelog, https://github.com/anusara-bemal/synfig-mcp/blob/v1.0.0/CHANGELOG.md
+Author: Synfig MCP Contributors
+Author-email: ABM <anusarabemal805@gmail.com>
+License-Expression: MIT
+Keywords: ai,animation,llm,mcp,synfig
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Video
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: anyio>=4.3.0
+Requires-Dist: lxml>=5.2.0
+Requires-Dist: mcp>=1.2.0
+Requires-Dist: numpy>=1.26.0
+Requires-Dist: pillow>=10.3.0
+Requires-Dist: pydantic>=2.7.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: structlog>=24.1.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: bandit>=1.7.8; extra == 'dev'
+Requires-Dist: hypothesis>=6.100.0; extra == 'dev'
+Requires-Dist: mypy>=1.10.0; extra == 'dev'
+Requires-Dist: poethepoet>=0.25.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest>=8.2.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Requires-Dist: syrupy>=4.6.0; extra == 'dev'
+Requires-Dist: tiktoken>=0.7.0; extra == 'dev'
+Requires-Dist: types-jsonschema>=4.21.0.20240118; extra == 'dev'
+Requires-Dist: types-lxml>=2024.4.14; extra == 'dev'
+Requires-Dist: types-pillow>=10.2.0.20240520; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# synfig-mcp
+
+[![Server CI](https://github.com/anusara-bemal/synfig-mcp/actions/workflows/server-ci.yml/badge.svg?branch=v1.0.0)](https://github.com/anusara-bemal/synfig-mcp/actions/workflows/server-ci.yml)
+[![PyPI](https://img.shields.io/badge/pypi-synfig--mcp-blue.svg)](https://pypi.org/project/synfig-mcp/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/anusara-bemal/synfig-mcp/blob/v1.0.0/LICENSE)
+
+**Model Context Protocol server for Synfig Studio — live canvas automation with a headless fallback.**
+
+This package provides the Python MCP server. It can drive a running patched Synfig Studio over an authenticated local bridge, or operate entirely headless using the `synfig` CLI.
+
+Full documentation, screenshots, client setup, and prebuilt Studio bundles: **[github.com/anusara-bemal/synfig-mcp](https://github.com/anusara-bemal/synfig-mcp)**.
+
+## Install
+
+```bash
+uv pip install "synfig-mcp @ https://github.com/anusara-bemal/synfig-mcp/releases/download/v0.8.0-rc2/synfig_mcp-0.8.0rc2-py3-none-any.whl"
+```
+
+Or from source:
+
+```bash
+uv pip install "git+https://github.com/anusara-bemal/synfig-mcp.git#subdirectory=server"
+```
+
+## Use
+
+```bash
+synfig-mcp doctor
+synfig-mcp
+```
+
+Example MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "synfig": {
+      "command": "synfig-mcp",
+      "env": {
+        "SYNFIG_MCP_PROFILE": "core",
+        "SYNFIG_MCP_BACKEND": "auto"
+      }
+    }
+  }
+}
+```
+
+## Operating modes
+
+| Mode | Backend | Use case |
+|---|---|---|
+| `auto` | Live if reachable, otherwise headless | Desktop |
+| `live` | Patched Synfig Studio | Interactive editing with undo/redo |
+| `headless` | SIF engine + `synfig` CLI | Servers, CI, containers |
+
+## Tool profiles
+
+`SYNFIG_MCP_PROFILE` selects the exposed tools:
+
+| Profile | Tools | Approx. tokens |
+|---|---:|---:|
+| `core` (default) | 12 | ~2,658 |
+| `anim` | 14 | ~3,800 |
+| `fx` | 21 | ~4,200 |
+| `rig` | 12 | ~2,800 |
+| `assets` | 10 | ~1,900 |
+| `review` | 15 | ~3,900 |
+| `all` | 56 | ~18,500 |
+
+## Configuration
+
+| Variable | Default | Description |
+|---|---|---|
+| `SYNFIG_MCP_PROFILE` | `core` | Tool profile |
+| `SYNFIG_MCP_BACKEND` | `auto` | `auto`, `live`, or `headless` |
+| `SYNFIG_MCP_HOST` / `SYNFIG_MCP_PORT` | `127.0.0.1` / `19998` | Live bridge endpoint |
+| `SYNFIG_MCP_TOKEN_PATH` | `~/.synfig/mcp_token` | Bridge token |
+| `SYNFIG_MCP_WORKSPACE_ROOTS` | `~/Documents/SynfigMCP` | Sandbox roots |
+
+## Development
+
+```bash
+cd server
+uv sync --locked --all-extras
+uv run poe check
+```
+
+## License
+
+The Python server is MIT licensed. The native bridge and patched Studio binaries are GPL-3.0-or-later. See [LICENSE](https://github.com/anusara-bemal/synfig-mcp/blob/v1.0.0/LICENSE) and [docs/gpl-compliance.md](https://github.com/anusara-bemal/synfig-mcp/blob/v1.0.0/docs/gpl-compliance.md).

synfig_mcp-1.0.3/README.md

@@ -0,0 +1,90 @@
+# synfig-mcp
+
+[![Server CI](https://github.com/anusara-bemal/synfig-mcp/actions/workflows/server-ci.yml/badge.svg?branch=v1.0.0)](https://github.com/anusara-bemal/synfig-mcp/actions/workflows/server-ci.yml)
+[![PyPI](https://img.shields.io/badge/pypi-synfig--mcp-blue.svg)](https://pypi.org/project/synfig-mcp/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/anusara-bemal/synfig-mcp/blob/v1.0.0/LICENSE)
+
+**Model Context Protocol server for Synfig Studio — live canvas automation with a headless fallback.**
+
+This package provides the Python MCP server. It can drive a running patched Synfig Studio over an authenticated local bridge, or operate entirely headless using the `synfig` CLI.
+
+Full documentation, screenshots, client setup, and prebuilt Studio bundles: **[github.com/anusara-bemal/synfig-mcp](https://github.com/anusara-bemal/synfig-mcp)**.
+
+## Install
+
+```bash
+uv pip install "synfig-mcp @ https://github.com/anusara-bemal/synfig-mcp/releases/download/v0.8.0-rc2/synfig_mcp-0.8.0rc2-py3-none-any.whl"
+```
+
+Or from source:
+
+```bash
+uv pip install "git+https://github.com/anusara-bemal/synfig-mcp.git#subdirectory=server"
+```
+
+## Use
+
+```bash
+synfig-mcp doctor
+synfig-mcp
+```
+
+Example MCP client configuration:
+
+```json
+{
+  "mcpServers": {
+    "synfig": {
+      "command": "synfig-mcp",
+      "env": {
+        "SYNFIG_MCP_PROFILE": "core",
+        "SYNFIG_MCP_BACKEND": "auto"
+      }
+    }
+  }
+}
+```
+
+## Operating modes
+
+| Mode | Backend | Use case |
+|---|---|---|
+| `auto` | Live if reachable, otherwise headless | Desktop |
+| `live` | Patched Synfig Studio | Interactive editing with undo/redo |
+| `headless` | SIF engine + `synfig` CLI | Servers, CI, containers |
+
+## Tool profiles
+
+`SYNFIG_MCP_PROFILE` selects the exposed tools:
+
+| Profile | Tools | Approx. tokens |
+|---|---:|---:|
+| `core` (default) | 12 | ~2,658 |
+| `anim` | 14 | ~3,800 |
+| `fx` | 21 | ~4,200 |
+| `rig` | 12 | ~2,800 |
+| `assets` | 10 | ~1,900 |
+| `review` | 15 | ~3,900 |
+| `all` | 56 | ~18,500 |
+
+## Configuration
+
+| Variable | Default | Description |
+|---|---|---|
+| `SYNFIG_MCP_PROFILE` | `core` | Tool profile |
+| `SYNFIG_MCP_BACKEND` | `auto` | `auto`, `live`, or `headless` |
+| `SYNFIG_MCP_HOST` / `SYNFIG_MCP_PORT` | `127.0.0.1` / `19998` | Live bridge endpoint |
+| `SYNFIG_MCP_TOKEN_PATH` | `~/.synfig/mcp_token` | Bridge token |
+| `SYNFIG_MCP_WORKSPACE_ROOTS` | `~/Documents/SynfigMCP` | Sandbox roots |
+
+## Development
+
+```bash
+cd server
+uv sync --locked --all-extras
+uv run poe check
+```
+
+## License
+
+The Python server is MIT licensed. The native bridge and patched Studio binaries are GPL-3.0-or-later. See [LICENSE](https://github.com/anusara-bemal/synfig-mcp/blob/v1.0.0/LICENSE) and [docs/gpl-compliance.md](https://github.com/anusara-bemal/synfig-mcp/blob/v1.0.0/docs/gpl-compliance.md).

synfig_mcp-1.0.3/pyproject.toml

@@ -0,0 +1,135 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "synfig-mcp"
+version = "1.0.3"
+description = "Live MCP control of Synfig Studio (native bridge + headless fallback)"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+authors = [
+    { name = "ABM", email = "anusarabemal805@gmail.com" },
+    { name = "Synfig MCP Contributors" },
+]
+keywords = ["mcp", "synfig", "animation", "llm", "ai"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Multimedia :: Graphics",
+    "Topic :: Multimedia :: Video",
+    "Typing :: Typed",
+]
+
+dependencies = [
+    "mcp>=1.2.0",
+    "pydantic>=2.7.0",
+    "lxml>=5.2.0",
+    "anyio>=4.3.0",
+    "pillow>=10.3.0",
+    "numpy>=1.26.0",
+    "typer>=0.12.0",
+    "rich>=13.7.0",
+    "structlog>=24.1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/anusara-bemal/synfig-mcp"
+Documentation = "https://github.com/anusara-bemal/synfig-mcp/tree/v1.0.0/docs"
+Repository = "https://github.com/anusara-bemal/synfig-mcp"
+Issues = "https://github.com/anusara-bemal/synfig-mcp/issues"
+Changelog = "https://github.com/anusara-bemal/synfig-mcp/blob/v1.0.0/CHANGELOG.md"
+
+[project.optional-dependencies]
+dev = [
+    "poethepoet>=0.25.0",
+    "ruff>=0.4.0",
+    "mypy>=1.10.0",
+    "pytest>=8.2.0",
+    "pytest-asyncio>=0.23.0",
+    "hypothesis>=6.100.0",
+    "syrupy>=4.6.0",
+    "bandit>=1.7.8",
+    "types-jsonschema>=4.21.0.20240118",
+    "types-lxml>=2024.4.14",
+    "types-Pillow>=10.2.0.20240520",
+    "tiktoken>=0.7.0",
+]
+
+[project.scripts]
+synfig-mcp = "synfig_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/synfig_mcp"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+    "ARG", # flake8-unused-arguments
+    "SIM", # flake8-simplify
+]
+ignore = [
+    "E501", # line too long (handled by formatter)
+]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+
+[[tool.mypy.overrides]]
+module = [
+    "lxml.*",
+    "jsonschema.*",
+]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+minversion = "8.0"
+testpaths = ["tests"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+markers = [
+    "real_studio: tests requiring real patched Synfig Studio binary",
+]
+filterwarnings = [
+    "ignore::DeprecationWarning",
+]
+
+[tool.poe.tasks]
+format = "ruff format src tests"
+format-check = "ruff format --check src tests"
+lint = "ruff check src tests"
+lint-fix = "ruff check --fix src tests"
+typecheck = "mypy src tests"
+test = "pytest -m 'not real_studio' -rs"
+live = "pytest -m real_studio -v -s"
+check = ["format-check", "lint", "typecheck", "test"]
+security = "bandit -r src/"
+verify-validity = "pytest tests/contract/test_sif_synfig_validity.py -v"

synfig_mcp-1.0.3/src/synfig_mcp/__init__.py

@@ -0,0 +1,5 @@
+"""
+synfig-mcp: Live Model Context Protocol control of Synfig Studio.
+"""
+
+__version__ = "0.8.0-rc2"

synfig_mcp-1.0.3/src/synfig_mcp/__main__.py

@@ -0,0 +1,8 @@
+"""
+Entrypoint for python -m synfig_mcp.
+"""
+
+from synfig_mcp.server import main
+
+if __name__ == "__main__":
+    main()

synfig_mcp-1.0.3/src/synfig_mcp/assets/__init__.py

@@ -0,0 +1,8 @@
+"""
+Licensed Asset Pipeline (Phase A5).
+"""
+
+from synfig_mcp.assets.models import AssetManifest, AssetMetadata, LicensePolicy
+from synfig_mcp.assets.pipeline import AssetPipeline
+
+__all__ = ["AssetManifest", "AssetMetadata", "AssetPipeline", "LicensePolicy"]

synfig_mcp-1.0.3/src/synfig_mcp/assets/models.py

@@ -0,0 +1,129 @@
+"""
+Data models for the Licensed Asset Pipeline, Provenance Manifest, and License Policies (Phase A5).
+"""
+
+from __future__ import annotations
+
+import datetime
+
+from pydantic import BaseModel, Field
+
+
+class LicensePolicy(BaseModel):
+    """
+    Configurable license policy for external assets.
+    Default configuration is strict: allows CC0/PDM, blocks ND/NC, flags BY/BY-SA.
+    """
+
+    allow_cc0: bool = Field(default=True, description="Allow CC0 / Public Domain Dedication.")
+    allow_pdm: bool = Field(default=True, description="Allow Public Domain Mark.")
+    allow_by: bool = Field(default=False, description="Allow CC BY (attribution required).")
+    allow_by_sa: bool = Field(default=False, description="Allow CC BY-SA (Share-Alike required).")
+    allow_commercial: bool = Field(
+        default=True, description="Whether project requires commercial use."
+    )
+    block_nd: bool = Field(default=True, description="Block NoDerivatives (we transform assets).")
+    block_nc: bool = Field(default=True, description="Block NonCommercial if commercial.")
+    skip_mature: bool = Field(default=True, description="Reject mature/NSFW flagged content.")
+
+    def evaluate_license(self, license_code: str, is_mature: bool = False) -> tuple[bool, str]:
+        """
+        Evaluate a license code against policy.
+        Returns: (allowed: bool, reason: str).
+        """
+        if self.skip_mature and is_mature:
+            return False, "Asset is flagged as mature content."
+
+        code = license_code.lower().strip()
+
+        if code in ("cc0", "pdm", "public-domain"):
+            return True, "Permitted by policy (Public Domain / CC0)."
+
+        if "nd" in code and self.block_nd:
+            return (
+                False,
+                f"License '{code}' contains No-Derivatives (ND) clause; animation transformations prohibited.",
+            )
+
+        if "nc" in code and self.block_nc and self.allow_commercial:
+            return (
+                False,
+                f"License '{code}' contains Non-Commercial (NC) restriction on a commercial project.",
+            )
+
+        if code == "by":
+            if self.allow_by:
+                return True, "Permitted by policy with attribution."
+            return False, "License 'by' requires attribution and is disabled under strict policy."
+
+        if code in ("by-sa", "sa"):
+            if self.allow_by_sa:
+                return True, "Permitted by policy with Share-Alike obligation."
+            return (
+                False,
+                "License 'by-sa' requires Share-Alike and is disabled under strict policy.",
+            )
+
+        return False, f"License '{code}' is not permitted under active policy."
+
+
+class AssetMetadata(BaseModel):
+    """Provenance and licensing metadata captured at download time."""
+
+    id: str = Field(description="Unique asset identifier (e.g. 'openverse_12345').")
+    provider: str = Field(description="Source provider ('openverse', 'wikimedia', 'local').")
+    title: str = Field(description="Asset title or filename.")
+    creator: str = Field(default="Unknown", description="Original creator or copyright holder.")
+    license_code: str = Field(description="Standard license identifier ('cc0', 'pdm', 'by', etc.).")
+    license_url: str = Field(default="", description="Authoritative URL for license terms.")
+    attribution_text: str = Field(default="", description="Ready-to-use attribution snippet.")
+    download_url: str = Field(default="", description="Original HTTPS source download URL.")
+    thumbnail_url: str | None = Field(default=None, description="Small preview URL.")
+    filesize_bytes: int = Field(default=0, description="Size on disk in bytes.")
+    sha256: str = Field(default="", description="Cryptographic SHA-256 hash.")
+    local_path: str = Field(default="", description="Local file path within workspace.")
+    retrieved_at: str = Field(
+        default_factory=lambda: datetime.datetime.now(datetime.UTC).isoformat(),
+        description="ISO 8601 UTC timestamp of download.",
+    )
+    rights_declaration: str = Field(
+        default="", description="Declared rights basis ('own', 'licensed', 'cc0', 'public-domain')."
+    )
+    mature: bool = Field(default=False, description="Whether asset is flagged as mature.")
+
+
+class AssetManifest(BaseModel):
+    """Collection manifest of all imported assets stored at assets/manifest.json."""
+
+    version: str = Field(default="1.0")
+    assets: list[AssetMetadata] = Field(default_factory=list)
+
+    def generate_attribution_md(self) -> str:
+        """Auto-generate ATTRIBUTION.md for legal compliance and project distribution."""
+        lines = [
+            "# Project Asset Attribution & License Provenance",
+            "",
+            "> Auto-generated by Synfig MCP Asset Pipeline.",
+            "> Every external asset used in this animation project is recorded with source and terms snapshot.",
+            "",
+            "| Asset Title | Creator | License | Provider | SHA-256 | Local File |",
+            "|---|---|---|---|---|---|",
+        ]
+        for a in self.assets:
+            c_link = f"[{a.creator}]({a.license_url})" if a.license_url else a.creator
+            lines.append(
+                f"| **{a.title}** | {c_link} | `{a.license_code.upper()}` | {a.provider} | `{a.sha256[:12]}...` | `{a.local_path}` |"
+            )
+
+        lines.extend(
+            [
+                "",
+                "## Attribution Statements",
+                "",
+            ]
+        )
+        for a in self.assets:
+            if a.attribution_text:
+                lines.append(f"- **{a.title}**: {a.attribution_text}")
+
+        return "\n".join(lines) + "\n"